▲ | bryanhogan 8 days ago | |
Because a "simple" docs site takes weeks or months of work that you could invest into other projects instead. What about Starlight or Vitepress is humongous? In this case the downsides don't outweigh the upsides, at least that was my first thought, hence I asked. | ||
▲ | jorangreef 8 days ago | parent | next [-] | |
Except, this didn’t take longer. In fact, it would have taken longer had we had to “sculpt” the dependencies. But—we also wouldn’t have had the same quality. Again, I don’t mean to suggest that you should necessarily “paint” like we do at TigerBeetle, but we’re happy with the time and quality of the project, that it (more than) met our standard. We’re not trying to impose TigerStyle on you, but it works for us. | ||
▲ | genericperson66 8 days ago | parent | prev [-] | |
Got you, I think the article made it clear that this solution did in fact not take months of work, as the heavy lifting is done by pandoc. The resulting solution is also very simple and can be understood completely in a short amount of time (very big upside). A framework based on node, typescript, npm etc. is by humongous by default. |