I am just beginning to write documentation for my open source projects. I have had some stumbles along the way but I am still learning how to communicate what each app/tool does.
Here are some of the basics that I am learning while drafting my docs:
nodeor another tool? Let the user know in the Dependencies section.
If you want a singular place for your documentation, blog about the project, and other materials, think about using a theme and hosting it on a service like Now, Netlify,or Surge.sh.
Picking a static site generator is the hardest part. There are a lot to choose from however whatever you choose should make getting markdown in and out of it relatively easy and the build time should be fast. I am using Docusaurus by Facebook.
I have my docs set up on Netlify and you can find them here and here.
Peak Windows programming was installing a wizard that helps create installation wizards
It happened. Today I was offered a Front-End Developer role and I will be relocating to Seattle. Words can’t even express how I feel. I turned the pain that I felt losing my father into motivation. All of the doubts, the effort that I put in, I can now say I am an engineer. Wow.
It’s been a good couple of weeks here in Central PA, at least for me. Will have more news as it comes.
P.S. If you like what I am doing here, be sure to subscribe, follow me on Twitter, buy me a coffee, a book, or support me on Buy Me a Coffee and share the love. You can also subscribe to this newsletter’s rss feed or you can ask me anything.