Skip to content

Move Key Commands doc script out of base repo folder#16024

Merged
seanbudd merged 4 commits intobetafrom
moveKeyCommandsDoc
Jan 11, 2024
Merged

Move Key Commands doc script out of base repo folder#16024
seanbudd merged 4 commits intobetafrom
moveKeyCommandsDoc

Conversation

@seanbudd
Copy link
Copy Markdown
Member

@seanbudd seanbudd commented Jan 10, 2024

Link to issue number:

Clean up of #15945

Summary of the issue:

The key commands doc generator script is in the base folder of the repository - it should be moved to a folder to keep the base repo tidy.
I propose it is moved to user_docs - particularly because of its relation to the docs, and the fact that the t2tconf files will be removed.

The documentation for key commands is lacking in the wiki: https://github.com/nvaccess/nvda/wiki/TranslatingUserGuide
The inline documentation in the module covers the syntax more thoroughly and should be moved to project docs.

Description of user facing changes

None

Description of development approach

Move folder

Testing strategy:

Test building user docs including key commands.

Known issues with pull request:

None

Code Review Checklist:

  • Documentation:
    • Change log entry
    • User Documentation
    • Developer / Technical Documentation
    • Context sensitive help for GUI changes
  • Testing:
    • Unit tests
    • System (end to end) tests
    • Manual testing
  • UX of all users considered:
    • Speech
    • Braille
    • Low Vision
    • Different web browsers
    • Localization in other languages / culture than English
  • API is compatible with existing add-ons.
  • Security precautions taken.

@seanbudd seanbudd requested a review from a team as a code owner January 10, 2024 04:29
@seanbudd seanbudd requested review from michaelDCurran and removed request for a team January 10, 2024 04:29
@seanbudd seanbudd added this to the 2024.1 milestone Jan 10, 2024
@AppVeyorBot
Copy link
Copy Markdown

See test results for failed build of commit a9b60ce428

@lukaszgo1
Copy link
Copy Markdown
Contributor

Shouldn't keyCommandsDoc.py be removed from the top level directory? For now it appears to be duplicated in user_docs.

@seanbudd
Copy link
Copy Markdown
Member Author

Thanks @lukaszgo1 - missed committing it

@seanbudd seanbudd merged commit 9675ea3 into beta Jan 11, 2024
@seanbudd seanbudd deleted the moveKeyCommandsDoc branch January 11, 2024 22:42
@hwf1324

This comment was marked as off-topic.

@seanbudd
Copy link
Copy Markdown
Member Author

This appears to not be relevant to this PR. Please open a new issue with more information - I'm not sure what you mean by this comment. Please include in the issue what files are causing problems, what the problems are, etc.

seanbudd pushed a commit that referenced this pull request Jan 19, 2024
Related #15945, #16024

Summary of the issue:
The documentation folder in the NVDA directory contains files that the user does not need.

For example: keyCommandsDoc.py

Description of user facing changes
The structure of the subfolders in documentation is the same as in the release version, with documentation/styles.css removed.

Description of development approach
In setup.py, exclude the corresponding file
Adriani90 pushed a commit to Adriani90/nvda that referenced this pull request Mar 13, 2024
Clean up of nvaccess#15945

Summary of the issue:
The key commands doc generator script is in the base folder of the repository - it should be moved to a folder to keep the base repo tidy.
I propose it is moved to user_docs - particularly because of its relation to the docs, and the fact that the t2tconf files will be removed.

The documentation for key commands is lacking in the wiki: https://github.com/nvaccess/nvda/wiki/TranslatingUserGuide
The inline documentation in the module covers the syntax more thoroughly and should be moved to project docs.
Adriani90 pushed a commit to Adriani90/nvda that referenced this pull request Mar 13, 2024
Related nvaccess#15945, nvaccess#16024

Summary of the issue:
The documentation folder in the NVDA directory contains files that the user does not need.

For example: keyCommandsDoc.py

Description of user facing changes
The structure of the subfolders in documentation is the same as in the release version, with documentation/styles.css removed.

Description of development approach
In setup.py, exclude the corresponding file
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants