semantic/ROADMAP.md

# Semantic Code Q2 FY2018 Roadmap

This quarter, we will focus on laying a foundation for future work.

See also our [roadmap project][].


## Objectives

- [Determine baselines](#determine-baselines)
- [Get our data into production](#get-our-data-into-production)
- [Improve our supported languages](#improve-our-supported-languages)

### Determine baselines

We will select specific metrics believed to be key to our objectives, e.g. performance.

Task                      | PRP | Priority (1 to 3) | Amount of work (1 to 4) | Score
----                      | --- | ----------------- | ----------------------- | -----
Determine what to measure |     |                   | ?                       | 0/1
Measure it                |     |                   | ???                     | 0/1


### Get our data into production

We will get our data into production and in front of customers.

Task                    | PRP        | Priority (1 to 3) | Amount of work (1 to 4) | Score
----                    | ---        | ----------------- | ----------------------- | -----
[Architecture review][] | @tclem     | 1                 | ✅                       | 1/1
Production readiness    | @tclem     | 1                 | ✅                       | 1/1
Table of contents       |            |                   | ✅                       | 1/1
GraphQL parse tree API  | @tclem     |                   | ✅                       | 1/1
GraphQL diff API        |            | 3                 | 2                       | 0/1
ToC in Enterprise       | @joshvera  | 2                 | ✅                       | 1/1


### Improve our supported languages

We will add support for Python, improve our support for Ruby, Go, and JavaScript/TypeScript, and explore integration with LSP servers.

Task                                | PRP        | Priority (1 to 3) | Amount of work (1 to 4) | Score
----                                | ---        | ----------------- | ----------------------- | -----
À la carte assignment of Python     | @rewinfrey | 2                 | ✅                       | 1/1
À la carte assignment of Go         |            |                   | 2?                      | 0/1
À la carte assignment of Ruby       |            |                   | ✅                      | 1/1
À la carte assignment of TypeScript |            |                   | 2?                      | 0/1
🚀 LSP integration                   | @joshvera  | 2                 | 4?                      | 0.5/1?
Migration to à la carte syntax      | @robrix    | 2                 | 3                       | 0/1

### BONUS ROUND!

We hadn’t planned on Bumblebee, but stuff got done anyway.

Task            | PRP        | Priority (1 to 3) | Amount of work (1 to 4) | Score
----            | ---        | ----------------- | ----------------------- | -----
[🐝][bumblebee] | @joshvera  | 1                 | ✅                       | 1/0


[roadmap project]: https://github.com/github/semantic-diff/projects/5
[Architecture review]: https://github.com/github/architecture/issues/12
[bumblebee]: https://donttrysohard.files.wordpress.com/2010/12/oprah-bees.gif
-												Note the timeframe in the title.

											
										
										
											2017-05-16 17:58:30 +03:00
+								# Semantic Code Q2 FY2018 Roadmap
-												Diff prototyping toolkit.

											
										
										
											2015-09-15 23:25:02 +03:00
-												Focus on laying a foundation.

											
										
										
											2017-05-18 18:16:07 +03:00
+								This quarter, we will focus on laying a foundation for future work.
-												Note the roadmap project.
											
										
										
											2016-09-13 17:51:25 +03:00
-												Don’t qualify.

											
										
										
											2017-05-18 18:16:01 +03:00
+								See also our [roadmap project][].
-												Move the see also bit to the top.

											
										
										
											2017-05-15 17:45:16 +03:00
-												Split up the work project-wise.

:tophat: @joshvera @tclem for this breakdown.

											
										
										
											2017-04-28 18:33:09 +03:00
-												Rename High-level goals to Objectives.

											
										
										
											2017-05-15 17:07:23 +03:00
+								## Objectives
-												Move ongoing work to specific projects

											
										
										
											2017-05-01 19:04:55 +03:00
-												Stub in a section for determining baselines.

											
										
										
											2017-05-17 18:02:49 +03:00
+								- [Determine baselines](#determine-baselines)
-												Rename the prod readiness section.

											
										
										
											2017-05-18 17:30:42 +03:00
+								- [Get our data into production](#get-our-data-into-production)
-												Repurpose the Python section.

											
										
										
											2017-05-18 18:12:43 +03:00
+								- [Improve our supported languages](#improve-our-supported-languages)
-												Move ongoing work to specific projects

											
										
										
											2017-05-01 19:04:55 +03:00
-												Stub in a section for determining baselines.

											
										
										
											2017-05-17 18:02:49 +03:00
+								### Determine baselines
-												Better intro for determining baselines.

											
										
										
											2017-05-18 18:09:05 +03:00
+								We will select specific metrics believed to be key to our objectives, e.g. performance.
-												Move ongoing work to specific projects

											
										
										
											2017-05-01 19:04:55 +03:00
-												Add Score columns.

											
										
										
											2017-05-18 18:27:29 +03:00
+								Task                      | PRP | Priority (1 to 3) | Amount of work (1 to 4) | Score
 								----                      | --- | ----------------- | ----------------------- | -----
-												Scoring, + 🐝
											
										
										
											2017-08-01 04:38:06 +03:00
+								Determine what to measure |     |                   | ?                       | 0/1
 								Measure it                |     |                   | ???                     | 0/1
-												Stub in a table for determining baselines.

											
										
										
											2017-05-18 18:04:01 +03:00
-												Rename the prod readiness section.

											
										
										
											2017-05-18 17:30:42 +03:00
+								### Get our data into production
-												Try to add a table for resilience &c.

											
										
										
											2017-05-15 17:58:59 +03:00
-												Rewrite the getting data into prod intro.

											
										
										
											2017-05-18 18:09:46 +03:00
+								We will get our data into production and in front of customers.
-												Add Score columns.

											
										
										
											2017-05-18 18:27:29 +03:00
+								Task                    | PRP        | Priority (1 to 3) | Amount of work (1 to 4) | Score
 								----                    | ---        | ----------------- | ----------------------- | -----
-												Scoring, + 🐝
											
										
										
											2017-08-01 04:38:06 +03:00
+								[Architecture review][] | @tclem     | 1                 | ✅                       | 1/1
 								Production readiness    | @tclem     | 1                 | ✅                       | 1/1
 								Table of contents       |            |                   | ✅                       | 1/1
 								GraphQL parse tree API  | @tclem     |                   | ✅                       | 1/1
 								GraphQL diff API        |            | 3                 | 2                       | 0/1
 								ToC in Enterprise       | @joshvera  | 2                 | ✅                       | 1/1
-												Add an entry for what our service provides.

											
										
										
											2017-05-15 18:08:50 +03:00
-												Repurpose the Python section.

											
										
										
											2017-05-18 18:12:43 +03:00
+								### Improve our supported languages
-												Add an objective for serving more of our users.

											
										
										
											2017-05-15 18:47:41 +03:00
-												Move LSP into improved language support.

											
										
										
											2017-05-18 18:22:08 +03:00
+								We will add support for Python, improve our support for Ruby, Go, and JavaScript/TypeScript, and explore integration with LSP servers.
-												Add an objective for serving more of our users.

											
										
										
											2017-05-15 18:47:41 +03:00
-												Add Score columns.

											
										
										
											2017-05-18 18:27:29 +03:00
+								Task                                | PRP        | Priority (1 to 3) | Amount of work (1 to 4) | Score
 								----                                | ---        | ----------------- | ----------------------- | -----
-												Scoring, + 🐝
											
										
										
											2017-08-01 04:38:06 +03:00
+								À la carte assignment of Python     | @rewinfrey | 2                 | ✅                       | 1/1
 								À la carte assignment of Go         |            |                   | 2?                      | 0/1
 								À la carte assignment of Ruby       |            |                   | ✅                      | 1/1
 								À la carte assignment of TypeScript |            |                   | 2?                      | 0/1
 								🚀 LSP integration                   | @joshvera  | 2                 | 4?                      | 0.5/1?
 								Migration to à la carte syntax      | @robrix    | 2                 | 3                       | 0/1
 								### BONUS ROUND!
 								We hadn’t planned on Bumblebee, but stuff got done anyway.
 								Task            | PRP        | Priority (1 to 3) | Amount of work (1 to 4) | Score
 								----            | ---        | ----------------- | ----------------------- | -----
 								[🐝][bumblebee] | @joshvera  | 1                 | ✅                       | 1/0
-												Fix the roadmap project link.
											
										
										
											2017-07-31 21:29:37 +03:00
 								[roadmap project]: https://github.com/github/semantic-diff/projects/5
-												Fix the architecture review link.
											
										
										
											2017-07-31 21:30:43 +03:00
+								[Architecture review]: https://github.com/github/architecture/issues/12
-												Scoring, + 🐝
											
										
										
											2017-08-01 04:38:06 +03:00
+								[bumblebee]: https://donttrysohard.files.wordpress.com/2010/12/oprah-bees.gif