Skip to content

Conversation

@shavounet
Copy link
Contributor

@shavounet shavounet commented Sep 17, 2021

Description

Today, reference documentation is lacking a lot of information, and some might be quickly obsolete...

The goal of this PR is to put a maximum of documentation right into PHPDoc

  • more visibility for people looking into code
  • less risk of difference between the code & doc

I tried to use https://phpdoc.org/ to generate a static website to help peeking into content.
image

There's still on-going documentation work. Some customization has been added in the .phpdoc folder

Requirements

  • Documentation updates
    • Reference : push more and more task / transformer reference into PHPDoc and remove the old .md file
    • Find some hosting solution
    • Cookbooks
    • Changelog
  • Unit tests

Implementation notes

To build the doc, use make build/sf4 doc

Breaking changes

None

@shavounet shavounet changed the title Use PHPDoc Use PHPDoc for Task & Transformer Reference Sep 17, 2021
@njoubert-cleverage
Copy link
Member

njoubert-cleverage commented Feb 20, 2025

Too much changes between proposal and main branch => So moved to #159

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants