# java/devjava-content architecture

> Architecture diagram of the GitHub repository java/devjava-content, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/java/devjava-content
- Repository: https://github.com/java/devjava-content

## Overview

Dev.java is the official Java platform and language website. Its product is a static content site: readers browse Java learning material, news, downloads, community and contribution resources; authors contribute articles through a proposal, editorial review and publication lifecycle documented in the README. The sampled build code shows Markdown/front-matter processing and link enrichment, but the rest of the render pipeline and runtime integration are not fully shown, so those connections are omitted. The content areas below reflect the tree and README, not an inspected runtime call graph.

Main entry points: [`gulpfile.js`](https://github.com/java/devjava-content/blob/main/gulpfile.js) (Site build and rendering), [`.github/ISSUE_TEMPLATE/content-proposal.yaml`](https://github.com/java/devjava-content/blob/main/.github/ISSUE_TEMPLATE/content-proposal.yaml) (Content proposal), [`README.md`](https://github.com/java/devjava-content/blob/main/README.md) (Pull request review), [`app/pages`](https://github.com/java/devjava-content/tree/main/app/pages) (Markdown content)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_content["Learning content"]
  node_tutorials["Java tutorials"]
  node_watch["Watch and listen<br/>[index.md]"]
  node_faq["FAQ and learning<br/>[index.md]"]
end

subgraph group_site["Site sections"]
  node_news["News"]
  node_download["Downloads"]
  node_community["Community"]
  node_future["Java future"]
  node_contribute["Contribute"]
end

subgraph group_editorial["Editorial workflow"]
  node_proposal["Content proposal"]
  node_pullrequest["Pull request review<br/>[README.md]"]
  node_publication["Scheduled and published<br/>[README.md]"]
end

subgraph group_build["Content rendering"]
  node_authors["Author records<br/>[authors.yaml]"]
  node_reference["Java reference data<br/>[javadoc.json]"]
  node_javafxreference["JavaFX reference data<br/>[javafxdoc.json]"]
  node_jeps["JEP reference data<br/>[jep.json]"]
  node_markdown["Markdown content"]
  node_renderer["Site build and rendering<br/>[gulpfile.js]"]
  node_templates["Page templates"]
end

node_reader(("Site reader"))
node_author(("Contributor"))
node_issues["GitHub issues"]

node_reader -->|"browses"| node_tutorials
node_reader -->|"browses"| node_watch
node_reader -->|"browses"| node_faq
node_reader -->|"browses"| node_news
node_reader -->|"browses"| node_download
node_reader -->|"browses"| node_community
node_reader -->|"browses"| node_future
node_reader -->|"browses"| node_contribute
node_author -->|"submits"| node_proposal
node_proposal -->|"tracks status"| node_issues
node_issues -->|"approved work"| node_pullrequest
node_pullrequest -->|"accepted content"| node_publication
node_markdown -->|"processes"| node_renderer
node_renderer -->|"reads links"| node_reference
node_renderer -->|"reads links"| node_javafxreference
node_renderer -->|"reads links"| node_jeps
node_renderer -->|"loads authors"| node_authors

click node_tutorials "https://github.com/java/devjava-content/tree/main/app/pages/learn/01_tutorial"
click node_watch "https://github.com/java/devjava-content/blob/main/app/pages/learn/02_watchlisten/index.md"
click node_faq "https://github.com/java/devjava-content/blob/main/app/pages/learn/03_faq/index.md"
click node_news "https://github.com/java/devjava-content/tree/main/app/pages/news"
click node_download "https://github.com/java/devjava-content/tree/main/app/pages/download"
click node_community "https://github.com/java/devjava-content/tree/main/app/pages/community"
click node_future "https://github.com/java/devjava-content/tree/main/app/pages/future"
click node_contribute "https://github.com/java/devjava-content/tree/main/app/pages/contribute"
click node_proposal "https://github.com/java/devjava-content/blob/main/.github/ISSUE_TEMPLATE/content-proposal.yaml"
click node_pullrequest "https://github.com/java/devjava-content/blob/main/README.md"
click node_publication "https://github.com/java/devjava-content/blob/main/README.md"
click node_authors "https://github.com/java/devjava-content/blob/main/app/data/authors.yaml"
click node_reference "https://github.com/java/devjava-content/blob/main/app/data/javadoc.json"
click node_javafxreference "https://github.com/java/devjava-content/blob/main/app/data/javafxdoc.json"
click node_jeps "https://github.com/java/devjava-content/blob/main/app/data/jep.json"
click node_markdown "https://github.com/java/devjava-content/tree/main/app/pages"
click node_renderer "https://github.com/java/devjava-content/blob/main/gulpfile.js"
click node_templates "https://github.com/java/devjava-content/tree/main/app/templates"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_tutorials,node_watch,node_faq toneBlue
class node_news,node_download,node_community,node_future,node_contribute toneAmber
class node_proposal,node_pullrequest,node_publication toneMint
class node_authors,node_reference,node_javafxreference,node_jeps,node_markdown,node_renderer,node_templates toneRose
class node_reader,node_author,node_issues toneIndigo
```

## Components

### Learning content

- [Java tutorials](https://github.com/java/devjava-content/tree/main/app/pages/learn/01_tutorial): `app/pages/learn/01_tutorial`
- [Watch and listen](https://github.com/java/devjava-content/blob/main/app/pages/learn/02_watchlisten/index.md): `app/pages/learn/02_watchlisten/index.md`
- [FAQ and learning](https://github.com/java/devjava-content/blob/main/app/pages/learn/03_faq/index.md): `app/pages/learn/03_faq/index.md`

### Site sections

- [News](https://github.com/java/devjava-content/tree/main/app/pages/news): `app/pages/news`
- [Downloads](https://github.com/java/devjava-content/tree/main/app/pages/download): `app/pages/download`
- [Community](https://github.com/java/devjava-content/tree/main/app/pages/community): `app/pages/community`
- [Java future](https://github.com/java/devjava-content/tree/main/app/pages/future): `app/pages/future`
- [Contribute](https://github.com/java/devjava-content/tree/main/app/pages/contribute): `app/pages/contribute`

### Editorial workflow

- [Content proposal](https://github.com/java/devjava-content/blob/main/.github/ISSUE_TEMPLATE/content-proposal.yaml): `.github/ISSUE_TEMPLATE/content-proposal.yaml`
- [Pull request review](https://github.com/java/devjava-content/blob/main/README.md): `README.md`
- [Scheduled and published](https://github.com/java/devjava-content/blob/main/README.md): `README.md`

### Content rendering

- [Author records](https://github.com/java/devjava-content/blob/main/app/data/authors.yaml): `app/data/authors.yaml`
- [Java reference data](https://github.com/java/devjava-content/blob/main/app/data/javadoc.json): `app/data/javadoc.json`
- [JavaFX reference data](https://github.com/java/devjava-content/blob/main/app/data/javafxdoc.json): `app/data/javafxdoc.json`
- [JEP reference data](https://github.com/java/devjava-content/blob/main/app/data/jep.json): `app/data/jep.json`
- [Markdown content](https://github.com/java/devjava-content/tree/main/app/pages): `app/pages`
- [Site build and rendering](https://github.com/java/devjava-content/blob/main/gulpfile.js): `gulpfile.js`
- [Page templates](https://github.com/java/devjava-content/tree/main/app/templates): `app/templates`

### Other components

- **Site reader**
- **Contributor**
- **GitHub issues**

## Connections

- Site reader → Java tutorials: browses (evidence: `README.md`)
- Site reader → Watch and listen: browses (evidence: `README.md`)
- Site reader → FAQ and learning: browses (evidence: `README.md`)
- Site reader → News: browses (evidence: `README.md`)
- Site reader → Downloads: browses (evidence: `README.md`)
- Site reader → Community: browses (evidence: `README.md`)
- Site reader → Java future: browses (evidence: `README.md`)
- Site reader → Contribute: browses (evidence: `README.md`)
- Contributor → Content proposal: submits (evidence: `README.md`)
- Content proposal → GitHub issues: tracks status (evidence: `README.md`)
- GitHub issues → Pull request review: approved work (evidence: `README.md`)
- Pull request review → Scheduled and published: accepted content (evidence: `README.md`)
- Markdown content → Site build and rendering: processes (evidence: `gulpfile.js`)
- Site build and rendering → Java reference data: reads links (evidence: `gulpfile.js`)
- Site build and rendering → JavaFX reference data: reads links (evidence: `gulpfile.js`)
- Site build and rendering → JEP reference data: reads links (evidence: `gulpfile.js`)
- Site build and rendering → Author records: loads authors (evidence: `gulpfile.js`)
