korbeil/jane-v8

All Jane components into one repository

dev-main 2024-07-15 19:42 UTC

This package is auto-updated.

Last update: 2024-10-15 20:08:10 UTC


README

Steps:

  • Parser (Fichier/JSON > Array)
  • Metadata (Json > Metadata)
  • Compiler (Metadata > Représentation PHP)
  • Generator (Représentation PHP > Code généré)

Todo

Before JSON Schema ALPHA-1

  • Fix OneOf fixture
  • More runtime tests in JSON Schema generator
  • Documentation from scratch (MkDocs)

Documentation

Jane uses Docsify to generate the documentation. While contributing to the Jane codebase, it is primordial to keep the documentation up-to-date.

First you will need to install Docsify

yarn global add docsify-cli

Then watch the documentatation folder

docsify watch /docs

Contributing

You can contribute this repository. To have an updated version of the code please checkout this repository, then:

composer update

Do your changes, before commit/creating a pull request, you should run:

composer cs-fix # will fix any coding style issue
composer cs-check # will check if you have any issue in your code thanks to PHPStan
composer tests # will run Jane's test suite

Once that is done, you can create your pull request. Please always think about updating the CHANGELOG file and add a test that is linked to the added feature or a non-regression test if you're fixing a bug.