sort sections by 'programming language' #69
Conversation
|
I sympathize with the layout problem but I strongly prefer to organize by use first. It highlights what the different uses are, which is what we want people to learn about JSON Schema (people already know about programming languages). What other layouts can we use to solve the problem? |
Did you mean that the current order is or should be based on the number of utilization? |
|
Er... no, I mean that I misunderstood what you were trying to do :-/ I'm going to leave this for @Relequestual . I get your point but the alphabetical ordering pushes languages that tend to be less associated with JSON and JSON Schema up to the front which feels a bit odd. Maybe we should just put in a sortable table rather than trying to figure out some single optimal presentation. |
|
👍 for sortable table |
|
Thanks for your effort on this. The worry about ordering being odd can be fixed by having a comma seperated list at the top of the section, which links to that section on the page. Would you be able to update your PR with this functionality please? Would be super appreciated! |
Relequestual
added
Priority: Low
Status: In Progress
Status: Revision Needed
Type: Maintenance
and removed
Type: Maintenance
labels
|
My pleasure! Temporarily I host a preview of this MR by GitHub Pages as a project page to be not confused by the diff @handrews ;) @Relequestual am I right to drop the current commit in favour of adding a sorted list of programming languages (right under each section headline) which are links to the start of the specific list?
I'd be glad to! |
|
@agebhar1 GREAT! Thanks for digging into this.
No, I was suggesting in addition to. I'm actually for logically clear ordering. |
|
Cool, if @Relequestual is for the new ordering than I'll support that- my objections were pretty weak to start with. |
|
Cool - I updated the preview with a 'button' area for all programming languages and introduce two new h3 headlines to distinguish libraries and online (tools). Thanks for your feedback! |
|
Ooh! could we get a button for the main sections? Only having a button for the languages within validators reinforces the impression that it's all about validators. |
|
The "main" section? |
I would say for 'Validators', 'Validator Benchmarks', 'Schema Generation' ... a 'table of content' (TOC) |
The list of validators exceeds the visual part of the »Software« page. In order to find the right (sub) list sort it by 'programming language' with common order. Non programming languages, mainly 'Online (web tool)', were shifted to the end of the list.
|
Yes- main sectionS (plural) is what I wrote, not singular. Validators, Validator Benchmarks', etc. That will highlight the things that are really hidden, which I find far more important than languages. |
I agree, a TOC should be added to get an impression on all (most) aspects of 'JSON Schema'. The heading 'Software' is maybe a bit misleading, but this should part of another issue. I'm busy at the weekend and will have a look next week with pleasure. It's also possible from my side to split the MR into two parts - one for sorting by programming language(s) and another for TOC and programming language links/overview. |
|
OK. In the interest of improving what we have now, might as well merge this one and let you follow up with another when you're free to do so. Thanks for your contribution =D |
The list of validators exceeds the visual part of the
»Software« page. In order to find the right (sub) list
sort it by 'programming language' with common order.
Non programming languages, mainly 'Online (web tool)',
were shifted to the end of the list.