You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
1.6 KiB
1.6 KiB
Contribution guidelines
Development environment
Prerequisites
- PHP 8.1+
makeentrto watch for file changesxdg-openlink handler to invoke browser- patience
Cloning or updating the repository
Ensure the consistency of the languages submodule by using the following options:
git clone --recurse-submodules <repository-url>git pull --recurse-submodules
Development
Run at least once: make fetch to query servers. This can take around 5 minutes.
Run when developing: make dev to watch for changes & serve HTML locally in browser.
Does not respond to new files.
See Makefile for more details.
Running your own copy
- point your webserver at the
outputfolder - install systemd services from the
systemdfolder or an equivalent timer session_sudoers: TBD
Code style guidelines
General
Indentation: Tabs (4-wide)
Filename seperator: Hyphen (-)
PHP
Identifier casing: snake_case and CONSTANT_CASE
Comments and documentation: PHPDoc
HTML & CSS
Identifier casing: kebab-case, legacy snake_case
Comments and documentation: PHP no-ops instead of HTML comments, if possible
JavaScript
Identifier casing: camelCase and CONSTANT_CASE, occasional snake_case for references to DOM
Comments and documentation: JSDoc
Contact
- Web Development Session Community on caliban.org
- Project lead, deployment, community filtering:
someguyon Session - Documentation, code quality, querying logic, HTML generation, CSS, JS:
gravelon Session