Hacker News new | ask | show | jobs
by jimmychoozyx 1044 days ago
https://docusaurus.io/ with its mermaidJS (diagrams as code) plugin.

i am working on turning my portfolio into a docusaurus site

i like it because it offers:

markdown docs w/ markdown diagrams, markdown blog, pages (as JSX)

- I'll use the docs aspect for two sections:

1. a set of portfolio projects

2. a set of boilerplate projects as a demo of my favorite devops & dev stack along with a brief description & tutorial for setting up the boilerplate.

- the pages aspect as the main page of my portfolio website, and maybe 1-2 other pages (perhaps one on career progression and one on the value proposition of my services)

- and then I'll have a markdown blog easily available as well, which I plan to use once a month or so to discuss what I've learned that month.

seems like a good & organized setup to me.