Skip to content

(PR65) Docs/Document Views - #191

Open
nikolaredstork wants to merge 21 commits into
mainfrom
docs/views-adaptation
Open

(PR65) Docs/Document Views#191
nikolaredstork wants to merge 21 commits into
mainfrom
docs/views-adaptation

Conversation

@nikolaredstork

@nikolaredstork nikolaredstork commented Jul 3, 2026

Copy link
Copy Markdown
Collaborator

Process ID

Process:
DOC-02

Description

This PR renames folder userguide/files-structure by userguide/input-files
The links from the pages to the ones inside the userguide are also updated

Others PRs of Views Builder will be merged inside this one, as its file structure defines the architecture of the others

Impact Analysis

none

Checklist

  • E2E tests pass (or confirmed not affected)
  • Library version bumped if library changed (library.version in libraries/<library>.yml)
  • Changelog entry added if library changed (libraries/CHANGELOG-<library>.md)
  • Release notes entry added if language-level change (doc/0_Home/4_release_notes.md)
  • Compatibility matrix updated if applicable (COMPATIBILITY.md)
  • Documentation updated or confirmed up to date
  • AGENTS.md reviewed for impact and updated if needed

@GuillaumeMaistre GuillaumeMaistre added documentation Improvements or additions to documentation rtei labels Jul 3, 2026
@GuillaumeMaistre GuillaumeMaistre changed the title (PR65) Docs Adaptation (PR65) Docs/ Views UserGuide Adaptation Jul 7, 2026

@aoustry aoustry left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Minor changes requested.

Comment thread doc/overview/file-structure.md Outdated
Comment thread doc/user-guide/input-files/view-config.md Outdated
Comment thread doc/user-guide/input-files/view-config.md Outdated
GuillaumeMaistre and others added 4 commits July 16, 2026 15:16
Co-authored-by: Antoine Oustry, PhD <58943406+aoustry@users.noreply.github.com>
Co-authored-by: Antoine Oustry, PhD <58943406+aoustry@users.noreply.github.com>
Co-authored-by: Antoine Oustry, PhD <58943406+aoustry@users.noreply.github.com>
@GuillaumeMaistre
GuillaumeMaistre requested a review from aoustry July 22, 2026 14:58
Comment thread doc/overview/file-structure.md Outdated
aoustry and others added 7 commits July 23, 2026 23:41
* update domains concenring views

* document views inside the table

* mention views inside glossary

* restructure table

* rename groups by categories

* use new architecture diagram

* integrate the data workflow inside the file structure page

* Update doc/overview/glossary.md

Co-authored-by: Antoine Oustry, PhD <58943406+aoustry@users.noreply.github.com>

* Update doc/overview/file-structure.md

Co-authored-by: Antoine Oustry, PhD <58943406+aoustry@users.noreply.github.com>

* Update doc/overview/file-structure.md

Co-authored-by: Antoine Oustry, PhD <58943406+aoustry@users.noreply.github.com>

* Update doc/overview/glossary.md

Co-authored-by: Antoine Oustry, PhD <58943406+aoustry@users.noreply.github.com>

* move the data workflow section

* update diagram architectural overview

* upate diagram

* Update taxonomy description in file structure

---------

Co-authored-by: Antoine Oustry, PhD <58943406+aoustry@users.noreply.github.com>
* create taxonomy file

* rename taxonomy example

* use antares legacy lib

* update taxonomy based on the library example

* delete views builder mentions

* apply suggestions

* add link to the models

* refactor & move the table

* delete logo header
* creation of catalog file

* mention new pages into mkdocs

* add links between every page

* change notebox to infobox

* catalog made by antares legacy example

* update link to legacy library

* rephrase intro

* delete logo headers

* update example based on the taxonomy example file

* move definition table

* refactor definition table

* Update doc/user-guide/input-files/catalog.md

Co-authored-by: Antoine Oustry, PhD <58943406+aoustry@users.noreply.github.com>

* Update doc/user-guide/input-files/catalog.md

Co-authored-by: Antoine Oustry, PhD <58943406+aoustry@users.noreply.github.com>

* Update doc/user-guide/input-files/catalog.md

Co-authored-by: Antoine Oustry, PhD <58943406+aoustry@users.noreply.github.com>

* Update doc/user-guide/input-files/catalog.md

Co-authored-by: Antoine Oustry, PhD <58943406+aoustry@users.noreply.github.com>

* Update doc/user-guide/input-files/catalog.md

Co-authored-by: Antoine Oustry, PhD <58943406+aoustry@users.noreply.github.com>

* deletion of legacy mention

* mention the taxonomy file but WITHOUT its  link

* add subsections for the catalog structure description

* define terms

* clarify terms definition

* add link to the antares legacy taxonomy

* Apply suggestion from @aoustry

---------

Co-authored-by: Antoine Oustry, PhD <58943406+aoustry@users.noreply.github.com>
* reformat vew-config

* add links

* mention view config files in mkdocs

* add catalog but with an under construction label

* change notebox

* delete catalog

* delete mention of catalog file

* update example of view config based on antares legacy libs

* refresh titles and use md title marks based on suggestions

* deletion of "yml" to refer to all files

* deletion of yml for mentionning view_config & add link to outputs/views page

* fix typo about *_* format

* fix syntax of Views writting
* update mermaid diagram

* update views output explanations file

* update links mentionning views file

* changing phrasing and add note

* change notebox

* delete builder mention

* adapt diagram to darkmode

* delete logo

* Update doc/user-guide/outputs/view.md

Co-authored-by: Antoine Oustry, PhD <58943406+aoustry@users.noreply.github.com>

* Views with an upper case and in plural

* deletion of yml particle for files

* refresh phrasing

* add column type

* rename views md file

* fix files renamming

* delete double md

* rename section

* add catalog file

* fix links

* delete duplicated line

* fix links

* file structure -> input files

* fix typos

---------

Co-authored-by: Antoine Oustry, PhD <58943406+aoustry@users.noreply.github.com>
@GuillaumeMaistre GuillaumeMaistre changed the title (PR65) Docs/ Views UserGuide Adaptation (PR65) Docs/Document Views Jul 24, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation rtei

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[DOC-02] Add documentation on Views, View Configurations and Catalogs [DOC-02] Add documentation on the Taxonomy file

3 participants