GitHub/mermaid
1
0
Fork 0
mirror of https://github.com/mermaid-js/mermaid.git synced 2025-01-28 07:03:17 +08:00
Code Issues Projects Releases Wiki Activity

feat: Add verification script for MERMAID_RELEASE_VERSION

Browse Source
This commit is contained in:
Sidharth Vinod 2024-08-24 17:57:36 +05:30
parent c95e997f8f
commit 0bfb42c68f
No known key found for this signature in database
GPG Key ID: FB5CCD378D3907CD
3 changed files with 16 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
docs/community/contributing.md
View File

@ -370,9 +370,9 @@ If the users have no way to know that things have changed, then you haven't real
Likewise, if users don't know that there is a new feature that you've implemented, it will forever remain unknown and unused. Likewise, if users don't know that there is a new feature that you've implemented, it will forever remain unknown and unused.
The documentation has to be updated for users to know that things have been changed and added! The documentation has to be updated for users to know that things have been changed and added!
If you are adding a new feature, add `(vMERMAID_RELEASE_VERSION+)` in the title or description. It will be replaced automatically with the current version number when the release happens. If you are adding a new feature, add `(v<MERMAID_RELEASE_VERSION>+)` in the title or description. It will be replaced automatically with the current version number when the release happens.
eg: `# Feature Name (vMERMAID_RELEASE_VERSION+)` eg: `# Feature Name (v<MERMAID_RELEASE_VERSION>+)`
We know it can sometimes be hard to code _and_ write user documentation. We know it can sometimes be hard to code _and_ write user documentation.

13
packages/mermaid/scripts/update-release-version.mts
View File

@ -5,7 +5,7 @@
* So contributors adding new features will only have to add the placeholder and not worry about updating the version number. * So contributors adding new features will only have to add the placeholder and not worry about updating the version number.
* *
*/ */
import { writeFile } from 'fs/promises'; import { readFile, writeFile } from 'fs/promises';
import { posix } from 'path'; import { posix } from 'path';
import { import {
getFilesFromGlobs, getFilesFromGlobs,
@ -18,7 +18,18 @@ import {
const verifyOnly: boolean = process.argv.includes('--verify'); const verifyOnly: boolean = process.argv.includes('--verify');
const versionPlaceholder = '<MERMAID_RELEASE_VERSION>'; const versionPlaceholder = '<MERMAID_RELEASE_VERSION>';
const verifyDocumentation = async () => {
const fileContent = await readFile('./src/docs/community/contributing.md', 'utf-8');
if (!fileContent.includes(versionPlaceholder)) {
console.error(
`The placeholder ${versionPlaceholder} is not present in the contributing.md file.`
);
process.exit(1);
}
};
const main = async () => { const main = async () => {
await verifyDocumentation();
const sourceDirGlob = posix.join('.', SOURCE_DOCS_DIR, '**'); const sourceDirGlob = posix.join('.', SOURCE_DOCS_DIR, '**');
const mdFileGlobs = getGlobs([posix.join(sourceDirGlob, '*.md')]); const mdFileGlobs = getGlobs([posix.join(sourceDirGlob, '*.md')]);
mdFileGlobs.push('!**/community/contributing.md'); mdFileGlobs.push('!**/community/contributing.md');

4
packages/mermaid/src/docs/community/contributing.md
View File

@ -371,9 +371,9 @@ If the users have no way to know that things have changed, then you haven't real
Likewise, if users don't know that there is a new feature that you've implemented, it will forever remain unknown and unused. Likewise, if users don't know that there is a new feature that you've implemented, it will forever remain unknown and unused.
The documentation has to be updated for users to know that things have been changed and added! The documentation has to be updated for users to know that things have been changed and added!
If you are adding a new feature, add `(vMERMAID_RELEASE_VERSION+)` in the title or description. It will be replaced automatically with the current version number when the release happens. If you are adding a new feature, add `(v<MERMAID_RELEASE_VERSION>+)` in the title or description. It will be replaced automatically with the current version number when the release happens.
eg: `# Feature Name (vMERMAID_RELEASE_VERSION+)` eg: `# Feature Name (v<MERMAID_RELEASE_VERSION>+)`
We know it can sometimes be hard to code _and_ write user documentation. We know it can sometimes be hard to code _and_ write user documentation.