2 ms·
So this is interesting to me in the context of having just released a Python framework (http://www.tetraframework.com http://www.tetraframework.com) and choosin
by samwillis 4y ago
So this is interesting to me in the context of having just released a Python framework (http://www.tetraframework.com http://www.tetraframework.com) and choosing to self host the docs.
It's something that I put a lot of thought into, but I decided to go that route for two reasons:
- I want to be able to embed into the docs working examples, as you often see in JavaScript front end framework docs. I could have done this by just embedding a Glitch for each example but I also intend the whole docs site to be a good example of how to build with the framework (once I flesh out routing). 15 years ago when I first found Django, it's site was the perfect reference to look at too see how to use Django in a larger context. (Maybe there is a correlation between proximity of a tool to the front end and self hosted docs)
- There is also a marketing aspect to it, I was to present Tetra as something significant. Show how much thought and work is going into it.
However your comment (and the situation with Requests) has been a nudge, I will be sure to mirror Tetras docs on to a docs hosting site too.