-
Notifications
You must be signed in to change notification settings - Fork 0
Docs/comments #12
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Docs/comments #12
Changes from all commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -5,4 +5,37 @@ module.exports = { | |
| ACKNOWLEDGEMENTS: require('./index.js'), | ||
| treeFileExtended: require('markdown-magic-transform-treefile-extended'), | ||
| }, | ||
| transformDefaults: { | ||
| treeFileExtended: { | ||
| '_file_descriptions.json': | ||
| 'A file containing descriptions for each file in the project.', | ||
| '.gitignore': | ||
| 'A file that specifies intentionally untracked files that Git should ignore.', | ||
| '.prettierrc.json': | ||
| 'A configuration file for Prettier, a code formatter.', | ||
| 'CHANGELOG.md': | ||
| 'A file that contains a curated, chronological list of notable changes for each version of a project.', | ||
| 'CONTRIBUTING.md': | ||
| 'A file that provides guidelines for how to contribute to the project.', | ||
| 'eslint.config.mjs': | ||
| 'A configuration file for ESLint, a tool for identifying and reporting on patterns found in ECMAScript/JavaScript code.', | ||
| 'index.js': | ||
| 'The main entry point of the application, containing the logic for the markdown-magic transform.', | ||
| LICENSE: | ||
| 'A file that contains the license for the project (MIT License).', | ||
| 'markdown-magic.config.js': | ||
| 'A configuration file for markdown-magic, a tool for automatically updating markdown files.', | ||
| 'package-lock.json': | ||
| 'A file that records the exact version of each installed dependency.', | ||
| 'package.json': | ||
| 'A file that contains metadata about the project and its dependencies.', | ||
| 'README.md': 'A file that provides a high-level overview of the project.', | ||
| 'RULES_OF_CONDUCT.md': | ||
| 'A file that outlines the rules of conduct for contributors to the project.', | ||
| '.github/workflows/ci.yml': | ||
| 'A GitHub Actions workflow file for continuous integration.', | ||
| '.github/workflows/release-please.yml': | ||
| 'A GitHub Actions workflow file for automating releases.', | ||
| }, | ||
| }, | ||
|
Comment on lines
+8
to
+40
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. While adding file descriptions is a great improvement for documentation, embedding this large object directly in |
||
| }; | ||
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The generated file tree is incomplete. It's missing dotfiles (e.g.,
.gitignore,.prettierrc.json) and the.githubdirectory, even though you've provided descriptions for them inmarkdown-magic.config.js. This can be misleading for readers. Themarkdown-magic-transform-treefile-extendedtransform likely has an option to include hidden files and directories. Please enable it to ensure the project structure is fully represented.