Developer Center Hackfest

Brussels, Monday 4th February 2018 and Tuesday 5th (After FOSDEM)

Note to attendees
This hackfest is currently a W.I.P proposal. Dates and location can be subject to change.

Primary contact: BastianIlsø (bastianilso, bastianilso (at) gnome.org)
Secondary contact: Philip Chimento (ptomato, philip (dot) chimento (at) gmail (dot) com)

Relevant GNOME teams

Infrastructure
Newcomers
GNOME Builder
GTK-Doc, Buildstream, GIR, Language bindings
GNOME Documentation Team

Description

The Developer Center hackfest is focusing on kickstarting an effort in GNOME to revamp the developer.gnome.org website and produce developer documentation based on the latest technologies in the GNOME stack. The GNOME Developer Center effectively provides one single place which combines API references of the GNOME stack with guides on specific topics maintained by the documentation team. However, the Developer Center currently faces many limitations such as API references being only available in C and with developer guides being out of date with high barrier of contribution.

These limitations has already been recognized and several people in the community has experimented with new systems which could become possible replacements, such as ReadTheDocs, HotDoc and more. The aim of the Developer Center is therefore, to try to assess what our community's requirements are to a new Developer Center and try to arrive at a proposal which can be evaluated and tested in a proper test instance with ongoing development hosted on a subdomain on gnome.org. Furthermore, the hackfest aims to gather members in the community interested in producing developer documentation, such as documentation guides and video tutorials for popular languages.

Agenda, goals

Create a public test instance of the next Developer Center.
Coordinate how GNOME Builder will include documentation, and how this might synergize with documentation on the GNOME web, ie. on developer.gnome.org.
Discuss the scope of developer.gnome.org, make a plan for how to solve possible low-maintenance/low-contribution issues (fx an annual hackfest producing new content?) and other isseus which has haunted this piece of infrastructure in the past.

Timeline

1st - 3rd February: FOSDEM
4th February: Hackfest

Attendees

Name	Relevant contribution/aim	Arrives on	Departs on	Staying at
BastianIlsø	Designer, Newcomer Guide	?	?	?
TobiasBernard	Designer	?	?	?
Ken VanDine	Docs for 3rd party developers	?	?	-
Philip Chimento	GJS Maintainer	?	?	-
Evan Welsh	GJS GSoC Student	?	?	-
Avi Zajac	GJS GSoC Student	?	?	-

Costs

todo

How to get there