Season of Docs/GSoD Ideas

From ScummVM :: Wiki
< Season of Docs
Revision as of 00:06, 4 May 2020 by Mataniko (talk | contribs) (Additional task details)
Jump to navigation Jump to search

If you'd like to get involved in ScummVM - or one of our sister projects, such as ResidualVM - we'd love to help you get started!

We've had a lot of successful student projects as part of Google's Summer of Code in previous years -- we hope to carry that success into Google's Season of Docs and inspire you to work with us and (hopefully) add your own success.

You should come to our Discord Server or IRC Channel and introduce yourself! We're friendly, and it's often the easiest way to ask questions about the tasks and the org in general. The channel is the main form of everyday communication for the project, and there will almost always be developers there who can discuss your project ideas, answer questions and help out.

You can find more information about what we expect from you before you apply at GSoD Application.

Introduction

TODO

Tasks

General contacts: Our Discord server, IRC channel, our mailing list, or contact sev, Matan Bareket, Arnaud Boutonné

The ideas here are meant to be just that - ideas. We hope they help inspire your proposals, but you should also consider suggesting your own completely new project ideas. Pick something you really want to see improved/fixed, and come and talk to us about it!

If you're looking for more inspiration for ideas, beware of our TODO (and the other TODO lists linked from there) and our OpenTasks pages. Many of the tasks listed there might be incomplete or outdated, or too difficult for a new developer. The best thing to do is to come and talk to us!

Documentation Portal

Technical contacts: mataniko

Difficulty level: Medium-hard. Might require some basic development skills if we opt in for something like Docusaurus

This task would collect the various pieces of information from the README, Wiki, and ports and help organize them in a new portal. The new portal can be based on either Markdown or ReStructuredText and will allow us having versioned manuals for ScummVM in a format that's easy to edit and distribute


As part of of this task, you and your mentors will work on:

  • Launching a new documentation portal (Docusaurus or readthedocs.io)
  • Consolidate existing documentation efforts
  • Define user journeys, document ScummVM's features, and create relevant manuals and guides.


Doxygen Refresh

Technical contacts: ?

Difficulty level: Medium. Requires the ability to read code, CSS and Doxygen experience a big plus.

Our doxygen page is woefully outdated - parts of the API aren't properly documented, long deprecated content is still around, and generally important pieces of code seem to be missing documentation. The project will focus on modernizing and updating our Doxygen site, potentially integrating it into the new docs portal as a future goal


As part of of this task, you and your mentors will work on:

  • Understanding the ScummVM code base and identifying important undocumented functions and classes
  • Improving the existing doxygen templates (https://doxygen.scummvm.org)