Add Windows environment notes / guide
I wrote a blog post detailing the necessary steps to get a working Minds development environment under Windows 10. I'd like to get the information included in the official documentation.
Hi, @omadrid, @ottman asked me to tag you for feedback on this as I'm unsure how this information would fit in to the current docs structure as the vast majority of the information in my post is only relevant to Windows developers.
My initial suggestion is to re-write the original blog post using markdown and adding it as a "blog" on the docs site itself. This "blog" feature isn't enabled on the docs app but it might be a good place to put blogs/articles/guides that are more specific than the pages in the existing Guides section. (e.g. I was thinking of writing another post about running the front-end natively as a follow up to my windows environment post) I'm mostly just looking for some feedback of where I should put this information that makes sense so Windows devs would see it without having to go looking. I'll submit a merge request with changes once we decide on how it should go.
- Re-write blog post with markdown as a docs blog
- Add windows issues to troubleshooting section in docs
changed the description
added scoped labels
- Owner
Right now https://developers.minds.com/docs/contributing/contributing/#ways-to-contribute directs to https://gitlab.com/groups/minds/-/issues?label_name%5B%5D=Bounty.
Realistically it should link to a page with an explanation of how bounties work and the gitlab link should be linked from there as a list of open bounties.
So @jim-toth, if @omadrid agrees, I would move your recommended bounty page/outline under to https://developers.minds.com/docs/contributing/contributing/
- Developer
Hey, cool! Looking forward to your contributions
Sounds like the best course of action is exactly what you've listed in your checkboxes in the issue description. Transform the content of your Minds blog into markdown, enable docs blogs and add it to the developer site as a blog, and then synthesize a few of the most salient points from the blog and add them to the existing docs (this could end up being in Troubleshooting or Installation... there's already a little bit just for Linux users in Installation so a blurb for Windows users wouldn't be totally out of place. Feel free to re-arrange that bit if it makes sense to do so).Seems like you're familiar with the docs already, but just in case, please take 15s to make sure you've read about headers first!
- Developer
Just ccing @xander-miller as I know he's been playing with the stack on Windows.
marked the task Re-write blog post with markdown as a docs blog as completed
marked the task Add windows issues to troubleshooting section in docs as completed
changed title from Add Windows environment notes / guide to Add Windows environment notes / guide