Update on the wiki front
It’s been a while, since we talked about #wikis, so I thought I’d make it a topic, again, with an update on the state of development of NIP-54.
-
@fiatjaf has identified the #Asciidoc rendering issue with special characters, so those weird “&bnsp” and similar errors should eventually disappear. 😊
-
I’ve been using Asciidoc, for a while, now, and it’s definitely a superior markup. Markdown is alright for plain articles (like this one), but a catastrophe, with anything even slightly more complex or professional.
-
I’ve found that the wiki events are excellent for project #documentation because they’re collaborative. Feels like using Confluence. We each fork from and deferr to, each others’ version, so it’s a similar experience to using git patches for documentation. (I store major changes as .adoc in git, tho, for versioning and backup.)
-
The current wiki clients are just missing a diff, kind 1111 comments, and highlights. Some of the formatting styles need to be tidied up, regarding fonts and spacing, and whatnot, and they need some more QC. I might do that for Wikistr, if I can find a lull in my GitCitadel tickets.
-
We have some ideas, for improving internal references (for example, footnotes), by making them into separate events, but that will be listed in the #NKBIP-03 page, that I’m about to write. (I will add a link to it, from here, later.) For now, I just use the Asciidoc syntax and it is rendered directly. I think this new event will take a long time, to structure properly, and we’ll pilot it in a later version of Alexandria.
-
If you have any factual/nonfiction information, that you think will be important to find, later, I would suggest you write it into a wiki page, not Kind 01. Not only does that improve its discoverability, it reduces the chance that relays will delete it.
-
We, at @GitCitadel have decided that wiki functionality makes sense, to integrate into #Alexandria v0.2.0, so that has been added to the work breakdown structure. I don’t expect us to have as much functionality, as a dedicated wiki app, such as Wikistr, but it will render the pages and the internal links will work.