GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Sign in
  • ActionsCI/CD and automation
  • CodespacesCloud development environments
  • All Features
  • Documentation
  • Training
  • Certifications
  • Build with Copilot
  • Customize Copilot
  • Integrations
  • Trending repos
  • GitHub Sponsors
  • Developer articles
  • Enterprises

This view

  • Original page
  • New address

GeezerVison is showing github.com — Documentation Revamp / Organisation · Issue #1350 · processing/processing4

Documentation Revamp / Organisation #1350

New issue
Copy link
New issue
Copy link
Open
Open
Documentation Revamp / Organisation#1350
Copy link
Labels
documentationImprovements or additions to documentationImprovements or additions to documentation

Description

@Stefterv
Stefterv
opened on Nov 27, 2025
Issue body actions

The examples and some of the documentation around Processing are kind of all over the place

The Goal

Have one repo where documentation lives: processing-website

The current issues

  • processing-website
    • updates processing4's keywords.txt based on content generated through processing-doclet
    • has to manually update content/examples and it is unclear that this data is partially read-only, the script applies processing-examples on top
    • content/contributions is also readonly and is no longer compatible with the new processing-contributions pipeline
  • processing4-javadocs does not automatically update with each release
  • processing-examples does not contain the images/livesketches/metadata that the website needs.
  • processing-doclet is a separate repo that will create the parsed javadoc comments for the website

Suggested actions

  • Get rid of any instances where the developer has to make sure repositories live next to each other on disk
  • Migrate processing-doclet into the processing-website and make it run on build
    • Research further into migrating / replicating the custom doclet into Gradle and make it run w gradle
  • Delete processing-doclet repo
  • Migrate processing-examples into the processing-website
    • Tested, still need to figure out how to merge the folders whilst keeping history
  • Archive processing-examples
  • Remove all read-only files from processing-website
  • Move the generation of keywords.txt back into the processing4 repo
  • Add an automatic update trigger for processing4-javadoc to the processing4 repo release action (or migrate processing4-javadoc into the processing4 repo)
    • Migrate Javadoc from Ant to Gradle

Related PRs/Issues/Other documentation

#1204

Reacted by glv

Activity

  1. Stefterv
    self-assigned this
    on Nov 27, 2025
  2. Stefterv
    added
    documentationImprovements or additions to documentationImprovements or additions to documentation
    on Nov 27, 2025
  3. Stefterv commented on Nov 27, 2025

    @Stefterv
    Stefterv
    on Nov 27, 2025
    MemberAuthor
    More actions

    Let me know if there is anything I missed @catilac @SableRaf

  4. SableRaf commented on Dec 15, 2025

    @SableRaf
    SableRaf
    on Dec 15, 2025
    Collaborator
    More actions

    I tried to summarize the current architecture (thanks Stef for your feedback)

    Image
    Reacted by Moon
  5. SableRaf commented on Dec 15, 2025

    @SableRaf
    SableRaf
    on Dec 15, 2025
    Collaborator
    More actions

    I can't be completely sure we're not missing any obscure dependencies but this should cover the big ones. I fully support any efforts to simplify and automate this legacy tangle of repos.

  6. Stefterv commented on Dec 16, 2025

    @Stefterv
    Stefterv
    on Dec 16, 2025
    MemberAuthor
    More actions

    For the examples directory seems like we can merge in the history

  7. Stefterv commented on Dec 16, 2025

    @Stefterv
    Stefterv
    on Dec 16, 2025
    MemberAuthor
    More actions

    For the Processing docket, I will move that functionality into the processing4 repo along with the functionality of the keywords.txt from the website

  8. catilac commented on Dec 17, 2025

    @catilac
    catilac
    on Dec 17, 2025
    Collaborator
    More actions

    I can't be completely sure we're not missing any obscure dependencies but this should cover the big ones. I fully support any efforts to simplify and automate this legacy tangle of repos.

    Yeah this is the thing I'm the most concerned about with this one. So I think we should move slowly and thoughtfully

    Reacted by Raphaël de Courville
  9. Stefterv
    removed their assignment
    on Feb 9, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationImprovements or additions to documentation

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions

      You are visitor 01402503 — GeezerVison does not store the pages you look up.
      Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.