I would love to get the following front page search experience:
Home page has folders. Folders can be public or private. azure-sdk-net is the main folder that contains API revisions from the main .NET GitHub branch. We would have corresponding folders for other languages. Users can create their named public or protected folders.
A folder cannot contain two entries with the same name (same package name).
We do reviews mainly on the Azure SDK folder APIs. Other folders are for random experiments. Only our build bot or privileged users can submit revisions to this folder.
No revisions can be submitted without a description of what the revision represents.
Language selection is sticky.
A left-hand side pane shows a list of sorted package names.
Above the pane, there is a filter edit box. As the user types in the box, the list in the pane below gets shorter.
Each package view has a section called "references". The section has links to useful related material. For example, docs, usage samples, etc. The section will be populated automatically with links to equivalent packages in other languages.
Each package revision has a URI. Diffs can be created by comparing two URIs regardless of which folder the URIs refer to. Diffs of two revisions of the same package can be created more easily with UI help (like it works today).
I feel like this experience would both make navigation easy, allow anybody and any team to use the tool (through their team folder), and would keep the tool independent from "services" and rather be a great tool for general library development.
I would love to get the following front page search experience:
I feel like this experience would both make navigation easy, allow anybody and any team to use the tool (through their team folder), and would keep the tool independent from "services" and rather be a great tool for general library development.