Logo
Pattern

Discover published sets by community

Explore tens of thousands of sets crafted by our community.

Documenting Code for Developers

15

Flashcards

0/15

Still learning
StarStarStarStar

Performance Considerations

StarStarStarStar

Document performance implications of code sections, explain the choice of algorithms, data structures, and any optimization techniques used.

StarStarStarStar

Version Control

StarStarStarStar

Use version control systems to track changes, document changes in commit messages, and link code changes to issue tracking.

StarStarStarStar

Unified Modeling Language (UML)

StarStarStarStar

Use UML diagrams to provide visual representations of system architecture, class relationships, and workflow processes.

StarStarStarStar

Function Docstrings

StarStarStarStar

Provide a brief description, list parameters and return types, use a consistent docstring format like JavaDoc or Doxygen.

StarStarStarStar

Error Handling Documentation

StarStarStarStar

Document how the code handles errors, list possible exceptions, and describe the error handling strategy.

StarStarStarStar

External Documentation

StarStarStarStar

Create external documentation like READMEs, wikis, or developer guides. Include setup instructions, dependencies, and examples.

StarStarStarStar

Localization and Internationalization

StarStarStarStar

Document any specific localization and internationalization considerations, such as language-specific comments and string handling.

StarStarStarStar

Code Deprecation and Compatibility

StarStarStarStar

Document deprecated code sections and provide information on compatibility with previous versions, mention alternatives if available.

StarStarStarStar

Commenting Code

StarStarStarStar

Use comments to explain the why, not the what. Ensure comments are updated along with code changes. Avoid obvious comments.

StarStarStarStar

Security Measures

StarStarStarStar

Document security measures in place, note secure coding practices, and explain the handling of sensitive data within the code.

StarStarStarStar

Automated Documentation Generators

StarStarStarStar

Utilize tools like Doxygen, Javadoc, or Sphinx to generate documentation from annotated source code.

StarStarStarStar

Naming Conventions

StarStarStarStar

Use clear and descriptive names for variables, functions, and classes. Follow the project's naming conventions consistently.

StarStarStarStar

Code Reviews

StarStarStarStar

Use code reviews as a process to improve code quality and documentation. Encourage documentation discussions during reviews.

StarStarStarStar

Inline Documentation

StarStarStarStar

Use inline documentation sparingly to explain complex or non-obvious code segments. Don't overuse, as it can clutter code.

StarStarStarStar

Code Structure

StarStarStarStar

Organize code logically, group related functions and variables, use whitespace and indentation for readability.

Know
0
Still learning
Click to flip
Know
0
Logo

© Hypatia.Tech. 2024 All rights reserved.