Re: HIG migration

[Allan Day <aday gnome org>]

Sriram Ramkrishna <sri ramkrishna me> wrote:
...
> I"m seeing more of this going forward - migration to gitlab pages. This is great - but at some point we'll 
> need to figure out how all this fits together coherently.

Good question.

> I assume you will update the developer.gnome.org web pages and any other housekeeping or is that going to 
> be up to engagement/docs teams? Don't want to assume :)

My impression from reading Emmanuele's blog [1] is that the current
incarnation of developer.gnome.org (ie. based on library-web) is going
away, and that API docs will be generated using Sphinx in the future.

The design team is likely to use something Sphinx-like, with a
customised theme. That theme could be used by other GNOME projects to
give our docs a consistent look. We could also potentially investigate
common navigation elements, like a home button that takes you to
developer.gnome.org.

Regarding developer.gnome.org itself, I think we could potentially do
a new static home page which links off to each of the independent
Sphinx-generated docs sites. This would need to be manually updated to
add new content, but that's probably a good thing.

Allan
-- 
[1] https://www.bassi.io/articles/2021/03/17/more-documentation-changes/