1. Developer Center Hackfest

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

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

1.1. Relevant GNOME teams

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

1.2. 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.

1.2.1. 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.

1.2.2. Timeline

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

1.2.3. Sponsors

1.3. Attendees

1.4. Costs

todo

1.5. How to get there

todo

1.6. Previous discussions, organization threads, drafts, relevant links, etc

• Plans for the Developer Center has previously been discussed at DeveloperExperience Hackfest 2016 and GTK+ Hackfest 2017

  • https://wiki.gnome.org/Hackfests/GTK2017/Day3

  • https://wiki.gnome.org/Hackfests/DeveloperExperience2016#Agenda

  • https://wiki.gnome.org/Design/Whiteboards/DeveloperCenter