Public Lab Wiki documentation



GSoD Ideas

This is a revision from April 22, 2019 16:35. View all revisions
5 | 11 | | #19139

plots2 system diagram and roadmap

Part of: https://github.com/publiclab/plots2

Description: PublicLab.org's codebase is described in a diagram of database models in our README, and documented in our data model README at https://github.com/publiclab/plots2/blob/master/doc/DATA_MODEL.md. But we need a better explanation and documentation of the major systems, not just the data model. This project will expand on the diagram to map out major systems such as:

  • editor
  • comment editor
  • tagging UI/API
  • standard node conventions
  • login system
  • revisions

It will also recap our roadmap for the codebase, including efforts to deprecate old code (https://github.com/publiclab/plots2/issues/956), consolidate and reorganize JavaScript code, and expand and extend our test suite. Finally, it will show interconnections between our different project repositories such as PublicLab.Editor, inline-markdown-editor, image-sequencer, leaflet-environmental-layers, leaflet-blurred-location and leaflet-blurred-location-display`.

List: plots-dev@googlegroups.com, https://publiclab.org/chat

Prerequisites: JavaScript, Ruby on Rails

Difficulty Level: medium

Potential mentors:

  • Jeff Warren

Gaurav Sachdeva

[prompt:text:plots2 system diagram mentor names here]


plots2 Ruby and JavaScript style guidelines

Part of: https://github.com/publiclab/plots2

Description: Coding style and consistency needs work and supporting documentation in our projects, and this project will include both clarity on which styles we follow, distinctions between recommendations and requirements, and guidance on running and using Rubocop or other linting and style review systems. It will also include providing supportive and non-negative style tips and feedback at key junctures such as automated PR reviews, and develop a re-usable issue workflow for taking up style-related issues in the first-timers-only system.

List: plots-dev@googlegroups.com, https://publiclab.org/chat

Prerequisites: JavaScript, Ruby on Rails

Difficulty Level: medium

Potential mentors:

  • Jeff Warren

Gaurav Sachdeva

[prompt:text:plots2 style guide mentor names here]


plots2 UI style and usage guide

Part of: https://github.com/publiclab/plots2

Description: We have a new UI Style Guide under development, and this project will expand, annotate, and document it, with examples, for those looking to add new pages and interfaces to our site.

Read more at: (coming soon)

List: plots-dev@googlegroups.com, https://publiclab.org/chat

Prerequisites: JavaScript, Ruby on Rails

Difficulty Level: medium

Potential mentors:

  • Jeff Warren

Gaurav Sachdeva

[prompt:text:Notifications system mentor names here]


leaflet-environmental-layers layer API and contributing guide

Part of: https://github.com/publiclab/leaflet-environmental-layers

Description:

Read more at:

List: plots-dev@googlegroups.com, https://publiclab.org/chat

Prerequisites: JavaScript

Difficulty Level: medium

Potential mentors:

  • Jeff Warren

[prompt:text:LEL contributing guide mentor names here]


ImageSequencer module API and contributing guide

Part of: https://github.com/publiclab/leaflet-environmental-layers

Description:

Read more at:

List: plots-dev@googlegroups.com, https://publiclab.org/chat

Prerequisites: JavaScript

Difficulty Level: medium

Potential mentors:

  • Jeff Warren

[prompt:text:IS contributing guide mentor names here]