docs: describe the lint-web workflow and add it to the glossary - add lint-web to the shipped workflows with its checks ESLint, Stylelint and html-validate - describe when it lints, its default rule sets and how a repository configuration replaces them, with an eslint.config.mjs example - name it in the FAQ for repositories that are not Nextcloud apps - regenerate the glossary with the lint-web term Signed-off-by: ernolf <raphael.gradenwitz@googlemail.com>
docs: note that the next image also leaves out the extensions that do not load - say in the target reference that an extension that builds but does not load is left out of the -next image and named in ncmake.missing Signed-off-by: ernolf <raphael.gradenwitz@googlemail.com>
docs: describe the php-compat run on the PHP ahead of Nextcloud master - add the run in ncmake-php:<minor>-next and NEXT=1 to the php-compat section, its options and examples - describe the php-next findings, build/php-compat/next and the run left out with RUNTIME=bare - describe the -next images and the label ncmake.missing in the target reference and the glossary Signed-off-by: ernolf <raphael.gradenwitz@googlemail.com>
docs: describe the master bound of the php-compat ceiling and the finding above it - stop the ceiling raised by <php max-version> at the ceiling of master in the php-compat table, the target reference and the glossary - add the [!] finding for a <php max-version> above the ceiling of master Signed-off-by: ernolf <raphael.gradenwitz@googlemail.com>
docs: regenerate the glossary with the cache-clean, JSON and npm cache terms Signed-off-by: ernolf <raphael.gradenwitz@googlemail.com>
docs: describe cache-clean, JSON=, build-verify --fresh, the php-compat lint and the npm cache Signed-off-by: ernolf <raphael.gradenwitz@googlemail.com>
docs: name the distutils the ncmake-node image carries - add python3-setuptools and the distutils it provides to the ncmake-node image in the container runtime section and the glossary - drop the claim that the buildpack-deps fallback carries the same tools Signed-off-by: ernolf <raphael.gradenwitz@googlemail.com>
docs: describe the ncmake-node image and its yarn 1 - describe ncmake-node, the node line from nodejs.org mounted at /usr/local and the yarn 1 it carries - name ncmake-node as the default of node_image and lib_node_image - describe how build-verify mounts the node line of the app - add ncmake-node to the glossary and update its node entries Signed-off-by: ernolf <raphael.gradenwitz@googlemail.com>
docs: describe the node schedule checks and the node build-verify builds on - describe the node-eol, node-unreleased and node-no-lts findings of consistency-audit - name the Node.js release schedule among what consistency-audit reads from the network - describe how build-verify runs on lib_node_image and builds on the Node of node_image - correct the lib_node_image row in per-app tuning - describe how ncmake picks the build Node from the release schedule, start dates included - describe the clean-up after a failed PHP image build - distinguish the two directions of a PHP floor difference between info.xml and composer.json - regenerate the glossary Signed-off-by: ernolf <raphael.gradenwitz@googlemail.com>
docs: describe the app store rules consistency-audit checks Signed-off-by: ernolf <raphael.gradenwitz@googlemail.com>
docs: describe the run-time directory check of consistency-audit Signed-off-by: ernolf <raphael.gradenwitz@googlemail.com>
docs: describe the git scratch tree of build-verify and the pruning fetch of git merged - say in Checkout audit that the scratch tree is a git repository with the HEAD and tags of the checkout - show the remote-tracking refspec in the merged alias of Git tips and explain why the prune needs it - update the scratch tree entry of the glossary Signed-off-by: ernolf <raphael.gradenwitz@googlemail.com>
docs(glossary): add the missing terms and link every page that uses each - Add 183 terms from all wiki pages, among them JavaScript, CSS, median, wall-clock and the integrity, workflow and image terms - Match terms regardless of case, keeping abbreviations such as ARGS, CI and PAT exact - Link every page a term occurs on instead of at most five - Explain that GITHUB_TOKEN is minted per workflow run and cannot change workflow files Signed-off-by: ernolf <raphael.gradenwitz@googlemail.com>
docs(glossary): add an index of every term with the pages using it - Add Glossary with a short meaning and links to the sections using each term - Link it from the sidebar and Home Signed-off-by: ernolf <raphael.gradenwitz@googlemail.com>
docs: bring Why ncmake and Step by step up to date - Add the analysers and the full release flow to the design bets - Limit the krankerl comparison to the steps both tools take - Add the checkout checks, the recommended workflow set, pre-releases and maintenance lines to Step by step Signed-off-by: ernolf <raphael.gradenwitz@googlemail.com>
docs: keep commands in the first table column on one line - Use non-breaking spaces and hyphens in the code spans of the first table column Signed-off-by: ernolf <raphael.gradenwitz@googlemail.com>
docs(build-tools): add a page on the bundlers apps use and what ncmake reads from them - Add Build-tools with the bundlers found across the App Store, their measured medians, strengths and weaknesses - Table the config files, output keys, aliases and glob imports ncmake reads per bundler - Link the page from the sidebar, Home and the Bundle-analysis FAQ Signed-off-by: ernolf <raphael.gradenwitz@googlemail.com>
docs(checkout-audit): take the build-verify output directories from the bundler config - Explain that build-verify compares the directories the bundler config writes to, falling back on js/ and css/ - Explain how source files inside an output directory are told apart from build output - Update the default row of the build-verify options table Signed-off-by: ernolf <raphael.gradenwitz@googlemail.com>
docs(git-tips): confirm git puh with a single y or n key
docs(checkout-audit): read the major on server master in consistency-audit Signed-off-by: ernolf <raphael.gradenwitz@googlemail.com>
docs(checkout-audit): describe make php-compat Signed-off-by: ernolf <raphael.gradenwitz@googlemail.com>
docs: pull the published PHP floor image and build it locally only as a fallback - the build image is ghcr.io/ernolf/ncmake-php:<min>, published for every PHP minor from the floor of the newest end-of-life Nextcloud major to the ceiling of master - a local build from the same Containerfile when php_extensions adds an extension the published image lacks or no source serves it, fingerprinted as ncmake.inputs - make php-containerfile in the target reference - the consistency audit compares the PHP extensions composer requires with the <lib> entries of info.xml Signed-off-by: ernolf <raphael.gradenwitz@googlemail.com>
docs: build the PHP floor image locally with the extensions of a Nextcloud server - How ncmake understands your app describes localhost/ncmake-php:<min>, built from php:<min>-cli-alpine with php_extensions, rebuilt on a newer base, and kept by the idle clean-up - Per-app tuning lists the new php_image default and php_base_image and php_extensions - Target reference adds the image-clean status built and what OWN=1 and OLD=1 do with it Signed-off-by: ernolf <raphael.gradenwitz@googlemail.com>
docs: start the composer step for composer/autoload.php only next to a composer.json Signed-off-by: ernolf <raphael.gradenwitz@googlemail.com>
docs: build on the official PHP image of the floor - How ncmake understands your app names php:<min>-cli-alpine as the build image and describes the per-run setup of git, unzip and composer, including su-exec under RUNTIME=docker - the image sources paragraph lists php among the Docker Official Images and no longer cites the Nextcloud CI images as unmatched - Per-app tuning shows the new php_image default in the example and the variable table Signed-off-by: ernolf <raphael.gradenwitz@googlemail.com>
docs(git-tips): list the changed files in git merged as git pull does Signed-off-by: ernolf <raphael.gradenwitz@googlemail.com>
docs(git-tips): keep settings and flags in the settings table unbroken Signed-off-by: ernolf <raphael.gradenwitz@googlemail.com>
docs: keep the alias and command cells of the short forms on one line - join the words of the Alias and Stands for cells with no-break spaces and the dashes with non-breaking hyphens, so the table does not wrap a command in the middle Signed-off-by: ernolf <raphael.gradenwitz@googlemail.com>
docs: lead each alias of Git tips with the commands it replaces - open the puh, merged and gone sections with the usual commands, then the alias, then its setup and details - add git gone, which fetches with --prune and deletes every local branch whose upstream is gone, except the one checked out - explain why gone reads the tracking state with LC_ALL=C git for-each-ref instead of filtering git branch -vv - add the short forms amend, st and lg - add a section on fetch.prune, pull.ff only and push.autoSetupRemote, and the git switch - tip Signed-off-by: ernolf <raphael.gradenwitz@googlemail.com>
docs: make the merged alias resumable after a failed step - fast-forward main with fetch origin main:main before switching, so a failed fetch leaves the branch checked out - take the branch as argument on main and pull with --ff-only there, so the alias can be run again after any step - prune gone remote-tracking refs and note that puh is simply run again after a failed push Signed-off-by: ernolf <raphael.gradenwitz@googlemail.com>