Ranter
Join devRant
Do all the things like
++ or -- rants, post your own rants, comment on others' rants and build your customized dev avatar
Sign Up
Pipeless API

From the creators of devRant, Pipeless lets you power real-time personalized recommendations and activity feeds using a simple API
Learn More
Comments
-
retoor53811dI hate everything regarding content management, so including docs. So I made a server doing:
- render jinja
- render markdown within jinja
- render syntax highlighting within markdown
- render python between {% py3 %} tags (so you can do advanced customization with it IF needed.). It works like php, print() / stdout will go to the right place in your body. You can mix the tag with any other.
- no reload for update required.
Im building a site with it right now, I'm reconstructing molodetz.nl with source code browsing. That's to the gitea api, I will be using my app to display / render and gitea is in charge of the content / being the backend. The optional inline python is so cool, insane comfortable. Just stole the best thing of php. Woei. -
I was so confused by your rant... Until I reread and noticed, you are not ranting about Norton.
-
jiraTicket229521hNever tried it, but seen people using it and sometimes wondered "am I missing out?" - glad to hear I'm not.
-
jiraTicket229521hI see you mention Confluence as a better option. Didn't expect that, thought it was looked down on. My org used it around 2015-2017 and I have memories of formatting getting in the way - like code having incorrect quote-chars. (Felt like it didn't use proper markdown..but maybe it was just my org who used it incorrectly)
We moved to Github wikis/readmes for code docs, and GoogleDrive suite for non technical stuff.
Now most Github wikis with code docs are nice and tidy markdown.
But I do miss the days when ALL the tech and semi-tech documentation was in one place in Confluence.
The shift lead to a strict separation of devs (with github accounts) and non-devs (like analytics people) and now analytics people write code snippets in god damn GoogleDocs 🤧
Related Rants
-
BingBangTheory46Long rant ahead, but it's worth it. I used to work with a professor (let's call him Dr. X) and developed a ba...
-
ashokramcse4
Best debugging tools 😜😜😜
-
fullstackcircus8boss: please look into tools that do X. fullstackchris: Ah, here's a solution we can use! boss: I don't want...
Does anyone actually like Notion? My current job uses it for all our documentation and I hate it. The organization is a mess, the search isn't great, and the UI sucks.
It's like a massive step backwards from tools like Confluence. I've had to use it for over three years and I still hate it.
rant
notion
wiki
tools