smore

4 ms·

1. 1.▲
   by smore 2y ago

   Great points about links, especially external links — it makes a lot more sense in the context of a documentation site where you might have the same external link referenced multiple times in the site, but you only want to have to update it
2. 2.▲
   by smore 2y ago

   > do we have a language server that can look up available references, headlines, figure names etc and help you auto complete? That would be a total gamechanger! Having the ability to do ref/doc links and not have to worry about stal
3. 3.▲
   by smore 2y ago

   Markdown has a great linter in markdownlint. When I worked in rST, I found the syntax to be super extensible, and tables much easier to write (list tables! amazing!) but without an effective linter, writing in rST was consistently painful.
4. 4.▲
   by smore 3y ago

   Thanks for reading! The source is my experience working in the industry and interacting with other technical writers and customer feedback submitted on doc pages, posted in Slack communities, and more. I've spent years reading comments