Extract GitLab's own markup code into this gem
As we have this Gem, and we will have to maintain it for (at least) some time, this popped up the idea of extracting our markup code and integrate it here.
We have at least one place where we could benefit using the same Markup code: our documentation portal.
By extracting the code we can:
- make it reusable outside of GitLab's main app.
- make it easier for anyone integrating with us to render the same markup code (considering it's a ruby app)
- make it easier for contributors to help improve / fix bugs (you don't need to understand the whole Rails app to find where to fix)
- improve the code (extracting will also means rewriting pieces of it, that will lead to rethink and probably better decisions)
Downsides:
- added complexity to synchronize releases (if we need to update / fix markup, we have to release a new gem version before)
- extracting / rewriting takes time
I don't know all the stakeholders that should be mentioned here, so I will start with @axil, but feel free to edit the description.
(We also need a volunteer to take this, if accepted)