Tag

documentation

0 views collected around this technical thread.

DevOps Engineer
DevOps Engineer
May 19, 2025 · R&D Management

The Pitfalls of Unmanaged Wiki Documentation in Enterprises and Lessons from Open Source

The article examines how unrestricted wiki editing in companies leads to duplicated, outdated, and low‑quality documentation, contrasts this with the disciplined PR‑based workflow of open‑source projects like Python, and argues that effective documentation governance depends on clear processes and cultural support rather than just tools.

Processdocumentationknowledge management
0 likes · 5 min read
The Pitfalls of Unmanaged Wiki Documentation in Enterprises and Lessons from Open Source
Architecture Digest
Architecture Digest
May 12, 2025 · Frontend Development

A Comprehensive Guide to Using Hugo for Static Site Generation

This article introduces Hugo, outlines its common application scenarios such as documentation sites and blogs, details core features like live preview, multilingual support, and theme system, and provides step‑by‑step installation and quick‑start instructions for Windows, macOS, and Linux.

DevOpsStatic Site GeneratorWeb Development
0 likes · 4 min read
A Comprehensive Guide to Using Hugo for Static Site Generation
IT Services Circle
IT Services Circle
May 9, 2025 · Frontend Development

Vue Ecosystem Embraces AI: Introducing llms.txt and vitepress-plugin-llms

The Vue ecosystem has taken a major step into artificial intelligence by adding llms.txt files to its documentation sites and releasing the vitepress-plugin-llms, which automatically generates AI‑friendly metadata to improve developer efficiency and document parsing.

AILLMs.txtPlugin
0 likes · 5 min read
Vue Ecosystem Embraces AI: Introducing llms.txt and vitepress-plugin-llms
Zhuanzhuan Tech
Zhuanzhuan Tech
Apr 18, 2025 · Artificial Intelligence

AI‑Powered Tools to Boost Java Development Efficiency: A Comprehensive Guide

An in‑depth guide reviews six leading AI‑driven development tools—including GitHub Copilot, Alibaba Cloud CodeWhisperer, Tabnine, Tencent Hunyuan DevBox, Amazon CodeWhisperer, and CodeGeeX—detailing their core features, use cases, security considerations, and selection advice for Java developers seeking to automate code generation, review, configuration, performance tuning, and documentation.

AICode GenerationDeveloper Tools
0 likes · 18 min read
AI‑Powered Tools to Boost Java Development Efficiency: A Comprehensive Guide
Code Mala Tang
Code Mala Tang
Apr 14, 2025 · Fundamentals

How to Write High‑Quality Python Code: 5 Practical Improvements

This article explains what makes code high‑quality—functionality, readability, maintainability, efficiency, and documentation—and demonstrates five concrete Python improvements, from type‑annotated inputs to clear naming, robust error handling, comprehensive docstrings, and performance‑boosting caching.

Best PracticesError HandlingPython
0 likes · 7 min read
How to Write High‑Quality Python Code: 5 Practical Improvements
DevOps Engineer
DevOps Engineer
Apr 13, 2025 · Fundamentals

Setting Up Sphinx and ReadTheDocs for Automated Documentation in Python Projects

This guide explains why Sphinx and ReadTheDocs are a powerful combination for generating and hosting documentation, and provides step‑by‑step instructions—including installing dependencies, initializing the project, configuring conf.py, adding a .readthedocs.yml file, and linking the repository—so that documentation is built automatically on each commit.

AutomationDevOpsPython
0 likes · 6 min read
Setting Up Sphinx and ReadTheDocs for Automated Documentation in Python Projects
Continuous Delivery 2.0
Continuous Delivery 2.0
Apr 3, 2025 · R&D Management

How to Leverage the Cursor AI Assistant in Large Projects through Effective Project Management Practices and Tool Configuration

This guide outlines practical project‑management practices and tool configurations—such as using Cursor rules, Notepad, milestone documents, and regular code‑base re‑indexing—to maximize the effectiveness of the Cursor AI assistant in large‑scale software projects.

AI AssistantBest PracticesCursor
0 likes · 6 min read
How to Leverage the Cursor AI Assistant in Large Projects through Effective Project Management Practices and Tool Configuration
Code Mala Tang
Code Mala Tang
Mar 12, 2025 · Fundamentals

Master Python Doctest: Embed Tests Directly in Your Docs

This guide explains how Python's built‑in doctest module lets you write test cases inside docstrings, run them from the command line or programmatically, handle common pitfalls like whitespace and floating‑point issues, and integrate doctests into larger projects for reliable documentation‑driven testing.

Pythoncode examplesdoctest
0 likes · 7 min read
Master Python Doctest: Embed Tests Directly in Your Docs
Test Development Learning Exchange
Test Development Learning Exchange
Mar 10, 2025 · Backend Development

Types of API Documentation and Their Appropriate Use Cases

This article explains the main types of API documentation—Swagger, Word, Excel, and PDF—describing their features, suitable scenarios, and how to convert between formats to improve API development and testing efficiency.

APIExcelPDF
0 likes · 4 min read
Types of API Documentation and Their Appropriate Use Cases
Architecture Development Notes
Architecture Development Notes
Dec 18, 2024 · Backend Development

How to Publish Your First Rust Crate: A Step‑by‑Step Guide

This article walks you through creating a Rust function to convert integers to Roman numerals, refining the code, and then turning it into a library and publishing it as a crate on crates.io, covering Cargo configuration, README creation, testing, documentation, and release steps.

CargoRustcrate publishing
0 likes · 9 min read
How to Publish Your First Rust Crate: A Step‑by‑Step Guide
Python Programming Learning Circle
Python Programming Learning Circle
Dec 17, 2024 · Fundamentals

How to Access and Use the Official Python Chinese Documentation

This article explains why the official Python documentation historically lacked a Chinese version, shows how to access the Chinese docs via https://docs.python.org/zh-cn, lists the available language versions and content coverage, and provides tips for searching within the translated documentation.

ReferenceTutorialchinese
0 likes · 4 min read
How to Access and Use the Official Python Chinese Documentation
Top Architect
Top Architect
Dec 1, 2024 · Fundamentals

Fundamentals of Software Design Documentation and UML Modeling

This article introduces the basics of software design documentation, explaining how software modeling and UML diagrams such as class, sequence, component, deployment, use case, state, and activity charts are used to capture domain problems and system architecture throughout requirement analysis, high‑level design, and detailed design phases.

Software ModelingUMLarchitecture
0 likes · 16 min read
Fundamentals of Software Design Documentation and UML Modeling
Java Tech Enthusiast
Java Tech Enthusiast
Nov 17, 2024 · Fundamentals

Types and Best Practices of Code Comments

Effective code comments fall into nine categories—six recommended types such as function, design, why, teacher, checklist, and guide comments, and three to avoid (trivial, debt, backup)—and using the right kind improves readability, maintenance, and AI‑assisted understanding of software projects.

Best Practicescode commentscoding standards
0 likes · 7 min read
Types and Best Practices of Code Comments
Architect's Guide
Architect's Guide
Nov 1, 2024 · R&D Management

The Importance of Documentation: Building a Documentation‑First Culture in Startups

This article argues that systematic documentation is a vital productivity booster for startups, explaining why written knowledge should precede meetings, how a documentation‑first culture reduces waste, improves onboarding, and fosters sustainable growth despite its limitations.

Asynchronous CommunicationR&D managementdocumentation
0 likes · 15 min read
The Importance of Documentation: Building a Documentation‑First Culture in Startups
Tencent Cloud Developer
Tencent Cloud Developer
Sep 19, 2024 · Product Management

Reading Notes and Reflections on "The Mythical Man-Month"

These reading notes dissect Brooks’s *The Mythical Man‑Month* anniversary edition, tracing its historical context, explaining the person‑month fallacy, Brooks’s law, and communication overhead, then mapping those lessons onto today’s agile, CI, modular testing practices while noting documentation trade‑offs and including community‑engagement promotions.

Mythical Man-Monthagiledocumentation
0 likes · 48 min read
Reading Notes and Reflections on "The Mythical Man-Month"
DevOps
DevOps
Sep 5, 2024 · Operations

Technical Growth and Engineering Practices: Foundations, Output, and the ‘Always Choose A’ Mindset

This reflective article shares the author’s journey through technical foundations, practical output, and mindset strategies—covering curiosity‑driven learning, cache and concurrency solutions, documentation to reduce tacit knowledge, and a proactive approach to career challenges—all aimed at strengthening engineering effectiveness.

CachingDevOpscareer development
0 likes · 13 min read
Technical Growth and Engineering Practices: Foundations, Output, and the ‘Always Choose A’ Mindset
FunTester
FunTester
Sep 4, 2024 · Operations

Reflections on Technical Growth: Foundations, Output, and Continuous Learning

The article shares a software engineer’s personal journey, emphasizing the importance of solid fundamentals, proactive output, curiosity‑driven problem solving, documentation, and process optimization to build lasting technical competence and reduce tacit knowledge throughout a career.

Cachingcareer developmentdocumentation
0 likes · 13 min read
Reflections on Technical Growth: Foundations, Output, and Continuous Learning
Go Programming World
Go Programming World
Jul 21, 2024 · Fundamentals

Chinese Copywriting Guidelines: Formatting Rules for Code Comments, README, and Documentation

This article introduces the Chinese copywriting guidelines, explaining why spaces between Chinese and English, numbers, units, and punctuation matter, providing concrete examples and best‑practice rules, and showcasing the autocorrect CLI tool and language libraries that can automatically enforce these formatting standards.

CLI toolChinese copywritingautocorrect
0 likes · 16 min read
Chinese Copywriting Guidelines: Formatting Rules for Code Comments, README, and Documentation
DevOps Cloud Academy
DevOps Cloud Academy
Jun 23, 2024 · Fundamentals

Generating Flowcharts and Diagrams with Mermaid and draw.io Using ChatGPT

This article explains how to use ChatGPT to generate Mermaid diagram code for flowcharts, sequence diagrams, Gantt charts, and entity‑relationship diagrams, and then import the code into the online drawing tool draw.io to create visual workflow charts, highlighting the benefits over manual drawing.

AutomationChatGPTMermaid
0 likes · 6 min read
Generating Flowcharts and Diagrams with Mermaid and draw.io Using ChatGPT