https://pantsbuild.org/ logo
f

fast-nail-55400

07/28/2022, 8:42 PM
๐Ÿงต on JVM documentation. I'd like to (1) rename that category to "JVM" instead of "Java & Scala" (since we have Kotlin); (2) split the
jvm-overview.md
into Java and Scala specific pages; and (3) move BSP to its own page. Thoughts?
โž• 1
cc @hundreds-father-404
h

hundreds-father-404

07/28/2022, 9:16 PM
I think these are great ideas! I'm not certain how we handle renaming categories with Readme.com..I suspect we do it in their editor, then update each pages's metadata block & filesystem location to line up correctly
h

happy-kitchen-89482

07/28/2022, 9:32 PM
I don't think you need to update the front matter, since it doesn't contain categories
AFAIK
You need to create new pages on readme.com anyway right now
h

hundreds-father-404

07/28/2022, 9:33 PM
true. I think the file org might matter the, like how subdirectories are set up etc
h

happy-kitchen-89482

07/28/2022, 10:25 PM
I'm not sure about that. I initially thought so too, but now I think the structure has to pre-exist.
And that is just how the export happened to arrange things
๐Ÿ‘ 1
we should obviously stick to that for our own sanity either way though
f

fast-nail-55400

07/28/2022, 10:58 PM
how are docs currently synced to readme?
h

happy-kitchen-89482

07/29/2022, 2:10 AM
Existing docs have their ID in the front matter, so the rdme tool takes care of it. But new docs don't have an ID or category yet, so there is an annoying dance where you have to create them on the web first.
๐Ÿ‘ 1
f

fast-nail-55400

07/29/2022, 1:28 PM
But what script does the sync?
h

hundreds-father-404

07/29/2022, 3:18 PM