Technical Authoring · Azure DevOps Server · On-Premises Deployment · Self-Hosted Agents · Windows · Persian Documentation
A comprehensive Persian-language technical guide for installing, configuring, administering, and using Microsoft Azure DevOps Server in a local/on-premises environment. Originally started in 2021 and now being fully refreshed against the latest on-premises release available from Microsoft, the book documents the complete experience step by step with original screenshots and detailed explanations of each major area of the platform.
1. Project Overview
This project is a complete Persian-language guide to Microsoft Azure DevOps Server in an on-premises environment.
The first edition was created in 2021.
The guide was not designed as a short installation tutorial.
Its purpose was to document the full path from:
Installation
↓
Initial Configuration
↓
Local Server Access
↓
Projects
↓
Repositories
↓
Boards
↓
Pipelines
↓
Agents
↓
Users / Permissions
↓
Day-to-Day Operation
The book explains the platform visually and step by step.
2. Current Revision
The original 2021 material is now being rebuilt and updated.
The new edition is based on:
the latest Azure DevOps Server release currently available from Microsoft for on-premises installation
The exact version number should be inserted into the final publication after the update process is complete, because screenshots and installation flow are still being refreshed.
3. Current Size
The current manuscript has reached approximately:
400 pages
The page count is not final.
Because the book explains the process screenshot by screenshot, a full revision may substantially change:
- chapter ordering,
- page count,
- screenshots,
- wording,
- and the amount of explanatory material.
4. Documentation Style
The guide follows a highly visual teaching model.
Rather than describing an operation only in prose:
Click Settings
Create Project
Configure Agent
the book documents each operation with:
- screenshot,
- highlighted context,
- action explanation,
- expected result,
- and explanation of what the screen actually does.
The goal is to remove ambiguity for Persian-speaking readers.
5. Target Audience
The guide is designed for readers who want to understand Azure DevOps Server from the beginning.
Potential readers include:
- junior developers,
- software teams,
- IT administrators,
- DevOps beginners,
- self-hosted development teams,
- students,
- Persian-speaking engineers moving from Git-only workflows to integrated DevOps environments.
6. Deployment Model
The book focuses on:
Local / On-Premises Azure DevOps Server
rather than Azure DevOps Services as a cloud-only workflow.
This distinction is important.
The reader learns how to own and operate the local server environment.
7. Operating Environment
The installation is demonstrated on a normal Windows environment rather than requiring a dedicated Windows Server operating system.
This lowers the barrier for:
- learning,
- experimentation,
- lab environments,
- local development,
- and small-team usage.
8. Database Strategy
The guide uses the database option bundled into the installation flow where appropriate.
The goal is not to force the reader into an unnecessarily complex SQL Server administration path.
For a local learning/development installation:
Azure DevOps Server
+
Bundled / Express SQL Option
is sufficient for the documented workflow.
9. Installation Philosophy
The guide is designed around:
minimum unnecessary infrastructure complexity
The reader should be able to learn the platform itself without first becoming a SQL Server infrastructure specialist.
10. Full Installation Flow
The installation section covers the complete setup process.
Conceptually:
Download
↓
Prerequisites
↓
Install
↓
Database Setup
↓
Configuration Wizard
↓
Application Tier
↓
Web Access
↓
Initial Collection / Project
Each step is documented visually.
11. Local Server Setup
The guide explains how to bring Azure DevOps Server into a usable local state.
This includes understanding:
- local URL/access,
- application configuration,
- browser access,
- server readiness,
- and initial project environment.
12. Project Creation
After installation, the book moves into actual usage.
The reader learns how to:
- create a project,
- understand project structure,
- choose relevant settings,
- and begin working with Azure DevOps as a development platform.
13. Azure Repos
The guide explains source-control functionality in detail.
Topics include:
- Git repositories,
- repository creation,
- cloning,
- branches,
- commits,
- push/pull workflow,
- repository permissions,
- and common repository operations.
14. Git Workflow
The book does not assume that the reader already understands every Git concept.
The material is intended to explain:
Local Repository
↕
Remote Repository
and how Azure DevOps participates in that workflow.
15. Branching
The repository section includes practical explanation of:
- branches,
- branch creation,
- branch switching,
- merge concepts,
- and team collaboration.
16. Pull Requests
Pull Requests are explained as part of the code-review and integration workflow.
Conceptually:
Feature Branch
↓
Pull Request
↓
Review
↓
Approval
↓
Merge
17. Azure Boards
The book explains Azure Boards rather than treating it as an optional extra.
This includes the purpose of:
- work items,
- boards,
- backlogs,
- tasks,
- bugs,
- user stories,
- planning views,
- and team tracking.
18. Work Items
Readers learn why work items exist and how they connect development activity to planning.
A work item can represent:
- task,
- bug,
- requirement,
- feature,
- story,
- or other planned work depending on the process model.
19. Backlogs
The guide explains how backlogs are used to organize work.
This includes:
- prioritization,
- hierarchy,
- planning,
- and relationship to iterations/sprints where applicable.
20. Boards
Boards are explained as a visual workflow layer.
The user learns how work progresses across states.
Example concept:
New
↓
Active
↓
Resolved
↓
Closed
or another process-specific state model.
21. Pipelines
A major section of the guide covers Azure Pipelines.
The book explains:
- what a pipeline is,
- why teams use pipelines,
- build automation,
- deployment concepts,
- jobs,
- stages,
- tasks,
- and execution flow.
22. CI/CD Concept
The guide introduces Continuous Integration and Continuous Delivery through practical Azure DevOps usage.
Conceptually:
Code Change
↓
Repository
↓
Pipeline
↓
Build
↓
Test
↓
Artifact
↓
Deployment
23. Pipeline Creation
The guide walks through creating and configuring pipelines rather than merely describing them.
The exact screenshots are being refreshed for the current edition.
24. Self-Hosted Agent
The book includes installation and configuration of a self-hosted agent.
This is a significant part of an on-premises Azure DevOps environment.
The reader learns how the server delegates work to an agent machine.
25. Agent Architecture
Conceptually:
Azure DevOps Server
↓
Job Queue
↓
Self-Hosted Agent
↓
Build / Script / Deployment Task
This explains the separation between orchestration and execution.
26. Agent Installation
The guide documents the agent installation process step by step.
This includes:
- download,
- configuration,
- connection to the server,
- agent pool,
- registration,
- and execution readiness.
27. Agent Pools
The book explains why agents belong to pools and how pools help organize execution resources.
This gives readers a better mental model than simply copying setup commands.
28. Pipeline Execution
Readers learn how to identify:
- queued job,
- selected agent,
- execution state,
- logs,
- failed tasks,
- successful runs.
29. Build Logs
The guide emphasizes that logs are not only output.
They are the primary diagnostic surface for pipeline execution.
This makes the material useful for troubleshooting as well as setup.
30. Artifacts
The book explains the concept of artifacts produced by build/deployment workflows.
Where supported by the chosen workflow, readers learn:
- why artifacts exist,
- how they are generated,
- how they are stored,
- and how downstream stages can use them.
31. Azure Artifacts
The broader Azure DevOps platform areas are explained individually.
Where relevant to the current server edition, package/artifact management is covered as part of the platform overview.
32. Users
The guide includes user administration.
Readers learn how users participate in projects and how access is controlled.
33. Groups
The relationship between:
Users
Groups
Permissions
is explained explicitly.
This is important in self-hosted environments where administration is part of the deployment responsibility.
34. Permissions
The guide explains permissions at different scopes.
Potential scopes include:
- organization/server level,
- collection,
- project,
- repository,
- pipeline,
- agent pool,
- and other service-specific scopes.
The exact UI depends on the server edition being documented.
35. Security Model
The book attempts to explain not only which button to click, but the underlying concept:
Identity
↓
Group Membership
↓
Permission
↓
Resource Access
This helps users reason about access-control problems.
36. Project Settings
Project Settings are documented section by section.
The reader learns:
- what each configuration area controls,
- when it matters,
- and what effect a change may have on the project.
37. Server / Collection Administration
The guide also explains the administrative areas relevant to the local deployment.
This separates:
Project Administration
from:
Server / Collection Administration
38. Complete UI Walkthrough
A core objective of the book is:
explain the function of every major area of Azure DevOps Server
The guide therefore does not stop after proving the installation works.
It continues through the platform itself.
39. Why the UI Walkthrough Matters
A reader may successfully install Azure DevOps Server and still not understand:
- where source code belongs,
- where tasks belong,
- where builds run,
- where agents are configured,
- where permissions live,
- or how different modules relate.
The book addresses that second problem.
40. Platform Mental Model
The book builds a mental model such as:
Azure DevOps Server
├── Projects
│ ├── Boards
│ ├── Repos
│ ├── Pipelines
│ ├── Artifacts
│ └── Settings
├── Users / Groups
├── Agent Pools
└── Administration
This helps readers understand the platform as a whole.
41. Screenshot-Driven Learning
Every major workflow is demonstrated visually.
This is particularly useful for Persian-speaking readers because many Microsoft interfaces and tutorials are documented primarily in English.
42. Original Screenshots
The new edition uses screenshots captured directly during a fresh installation and usage process.
This avoids depending on obsolete screenshots from the 2021 edition.
43. Screenshot Refresh
Because Azure DevOps Server UI and installation flows change over time, screenshots from the first edition are being replaced.
The update is therefore not merely:
change version number
It is:
re-run the complete workflow
+
capture the current UI
+
review all instructions
44. Clean-Room Revalidation
The updated edition can be described as a fresh validation pass.
The workflow is repeated from the beginning to ensure instructions still correspond to the current product.
45. Technical Authoring Method
The writing method follows:
Perform
↓
Capture
↓
Explain
↓
Verify
↓
Revise
This is closer to operational documentation than generic theoretical writing.
46. Persian Technical Language
The book is written in Persian.
Technical terms are preserved carefully where translation would make understanding harder.
The goal is to create a Persian explanation layer around the real Microsoft terminology.
47. Terminology Strategy
A useful pattern is:
Azure Pipeline
خط لوله / فرایند خودکار Build و Deployment
rather than inventing Persian terminology that prevents readers from recognizing the Microsoft interface.
48. Beginner Accessibility
The book assumes the reader may be starting from zero.
This means concepts are explained before advanced workflows are introduced.
49. Progressive Learning
The learning path is:
Install
↓
Understand Interface
↓
Create Project
↓
Use Repositories
↓
Manage Work
↓
Create Pipelines
↓
Configure Agent
↓
Understand Administration
This reduces cognitive overload.
50. Practical Focus
The project emphasizes operational use rather than certification-style memorization.
The reader is expected to actually install and use the system.
51. Publication Plan
The final book is intended for publication through:
Amazon / KDP
The manuscript is still under active revision.
52. Publication Status
Recommended status:
Major Revision / Updated Edition in Progress
Avoid describing the new edition as fully completed until:
- screenshots are finalized,
- version-specific text is verified,
- and final review is complete.
53. Original Edition
The original book/tutorial existed in 2021.
The surviving social-media evidence shows the topic:
local Azure DevOps Server installation and setup.
The current edition builds on that earlier work but is being substantially refreshed.
54. Current Manuscript Scale
Approximately:
400 pages
at the current stage.
Because the project is still under revision, the final page count may be higher or lower.
55. Why 400 Pages
The length results from:
- screenshot-by-screenshot explanation,
- detailed UI walkthroughs,
- full installation,
- configuration,
- individual feature explanations,
- and practical operation.
The book is intentionally not a short quick-start manual.
56. Scope Boundary
The book focuses on the on-premises server environment.
It should not be marketed as a complete reference to every Azure DevOps cloud-service capability if those capabilities are not available or demonstrated in the server edition.
57. Version Boundary
Because Microsoft changes the product over time, the final publication should clearly state:
- exact Azure DevOps Server release,
- operating environment,
- installation type,
- screenshot date,
- and relevant limitations.
This increases reproducibility.
58. Reproducibility
The strongest form of technical documentation is reproducible.
A reader should be able to follow the book and arrive at a working environment.
That is the standard this project aims to meet.
59. Troubleshooting Value
A screenshot-rich guide also helps readers identify where their environment diverges from the documented flow.
This makes screenshots diagnostic, not merely decorative.
60. Knowledge Areas Demonstrated
The project demonstrates:
- Azure DevOps Server
- On-Premises Deployment
- Windows Administration
- SQL Express-based setup
- Git
- Azure Repos
- Azure Boards
- Azure Pipelines
- Self-Hosted Agents
- Permissions
- Technical Writing
- Persian Localization
- Documentation Engineering
61. Why This Is More Than a Book
This project combines:
Technical Implementation
+
Platform Administration
+
Instructional Design
+
Technical Writing
+
Visual Documentation
The author must successfully perform the process before documenting it.
62. Technical Depth
A guide that covers only installation demonstrates setup knowledge.
A guide that continues through:
- Repos,
- Boards,
- Pipelines,
- Agents,
- Permissions,
- and administration
demonstrates broader platform understanding.
63. Portfolio Positioning
Recommended title:
Azure DevOps Server — Complete Persian On-Premises Guide
Alternative:
Azure DevOps Server from Zero — Persian Installation & Administration Guide
A final commercial title can be chosen later.
64. Portfolio Classification
Primary:
- Technical Publication
- DevOps
- System Administration
- Technical Education
Secondary:
- Azure DevOps Server
- Git
- CI/CD
- Windows
- Persian Technical Writing
65. Portfolio Tier
Recommended:
Tier A/B — Featured Technical Publication
The project is strong because it combines:
- real platform deployment,
- broad technical scope,
- 400-page manuscript scale,
- screenshot-level detail,
- current revalidation,
- and planned commercial publication.
66. Career Evidence
This project provides evidence of:
- DevOps Platform Administration
- Technical Documentation
- On-Premises Infrastructure
- CI/CD Concepts
- Build Agent Configuration
- Git Repository Management
- Access Control
- Educational Content Design
- Long-Form Technical Writing
- Product Version Migration
67. Website Hero
Azure DevOps Server — Complete Persian On-Premises Guide
DevOps · On-Premises Deployment · CI/CD · Self-Hosted Agents · Technical Authoring
A comprehensive Persian-language guide to installing, configuring, administering, and using Azure DevOps Server locally, with detailed screenshot-driven coverage of repositories, boards, pipelines, agents, permissions, and the broader platform.
68. Website Project Card
Azure DevOps Server — Persian Guide
DevOps · Technical Writing · Windows · CI/CD
A ~400-page screenshot-driven Persian guide covering complete local Azure DevOps Server installation, administration, repositories, boards, pipelines, self-hosted agents, and day-to-day usage.
69. Short Website Card
Azure DevOps Server Persian Guide
A complete Persian on-premises Azure DevOps Server guide covering installation, configuration, agents, Repos, Boards, Pipelines, permissions, and practical usage.
70. One-Line Description
Authored a ~400-page Persian guide to complete Azure DevOps Server on-premises installation, administration, CI/CD, self-hosted agents, and day-to-day platform usage.
71. CV Entry
Azure DevOps Server — Persian Technical Guide / DevOps / On-Premises Administration
Authored and maintained a comprehensive Persian-language Azure DevOps Server guide, originally created in 2021 and now being fully refreshed against the latest available on-premises release. The ~400-page manuscript documents installation on Windows, bundled SQL Express setup, project creation, Git repositories, Boards, Pipelines, self-hosted agents, permissions, administration, and the function of major platform areas through original step-by-step screenshots. Planned for publication through Amazon/KDP.
72. Short CV Entry
Authored a ~400-page Persian Azure DevOps Server guide covering on-premises installation, Repos, Boards, Pipelines, self-hosted agents, permissions, and administration.
73. Publication-Focused CV Entry
Developing an updated commercial Persian reference for Azure DevOps Server, rebuilt from a 2021 edition with a fresh installation, new screenshots, and complete feature-by-feature walkthroughs.
74. Interview Story — Situation
Persian-speaking developers had limited access to detailed, visual, end-to-end documentation for deploying Azure DevOps Server locally.
75. Interview Story — Task
Create a guide that could take a reader from zero to a functional local Azure DevOps environment and then teach them how the platform actually works.
76. Interview Story — Action
I installed the platform myself, documented every major step with screenshots, explained the installation and configuration process, then continued through projects, repositories, Boards, Pipelines, permissions, and self-hosted agents.
The original edition was created in 2021.
I am now repeating the complete process using the latest available on-premises release and replacing outdated screenshots and instructions.
77. Interview Story — Result
The current manuscript is approximately 400 pages and is being prepared for a major final revision and eventual Amazon publication.
78. Technical Interview Version
“I originally wrote this in 2021 because there was very little detailed Persian material for people who wanted to run Azure DevOps Server locally. I did not stop at installation. I documented the whole platform—projects, Git repositories, Boards, Pipelines, permissions and self-hosted agents—screen by screen. The manuscript is currently around 400 pages. I’m now rebuilding the whole walkthrough against the latest on-premises version from Microsoft, taking fresh screenshots and revalidating every step before the final Amazon edition.”
79. Documentation Engineering Lesson
The project demonstrates:
Documentation must be tested like software.
If a product changes:
Old Screenshot
+
Old Instruction
may become incorrect.
The correct response is to rerun the workflow.
80. Version Migration Lesson
A technical book should not pretend that a 2021 UI still represents a modern server version.
The current revision explicitly addresses that problem through fresh screenshots and revalidation.
81. Learning Design Lesson
Screenshot-heavy documentation works best when each image answers one concrete question.
The final revision can therefore optimize for:
One Concept
→ One Action
→ One Screenshot
→ One Explanation
where appropriate.
82. Recommended Final Book Structure
A possible final structure:
Part I — Concepts & Architecture
Part II — Installation
Part III — Initial Configuration
Part IV — Projects & Teams
Part V — Azure Repos / Git
Part VI — Azure Boards
Part VII — Azure Pipelines
Part VIII — Self-Hosted Agents
Part IX — Artifacts / Packages
Part X — Users, Groups & Permissions
Part XI — Administration
Part XII — Practical End-to-End Example
Part XIII — Troubleshooting
Part XIV — Reference / Quick Review
The final table of contents should reflect the exact current product.
83. Suggested Commercial Title Ideas
Potential titles:
- Azure DevOps Server از صفر تا اجرا
- راهنمای جامع Azure DevOps Server
- Azure DevOps Server به زبان فارسی
- Azure DevOps Server: نصب، مدیریت و CI/CD
- راهنمای تصویری Azure DevOps Server
- Azure DevOps Server On-Premises — راهنمای کامل فارسی
For an Amazon edition, a bilingual title may improve discoverability.
84. Suggested English Portfolio Title
Azure DevOps Server — Complete Persian On-Premises Guide
This is clear and internationally understandable.
85. Suggested Tags
Azure DevOps Server
DevOps
On-Premises
Windows
Git
Azure Repos
Azure Boards
Azure Pipelines
Self-Hosted Agent
CI/CD
Technical Writing
Persian
Documentation
System Administration
Amazon KDP
86. Suggested Website Metadata
Page Title
Azure DevOps Server — Complete Persian On-Premises Guide
Meta Description
A comprehensive Persian-language Azure DevOps Server guide covering complete local installation, SQL Express setup, repositories, Boards, Pipelines, self-hosted agents, permissions, administration, and practical usage through detailed original screenshots.
Suggested Slug
/azure-devops-server-persian-guide
87. Evidence Boundaries
Safe to claim:
- original project started in 2021,
- current manuscript approximately 400 pages,
- complete local/on-premises installation,
- normal Windows environment,
- bundled/Express database approach,
- project creation,
- explanation of all major platform areas,
- repositories,
- Boards,
- Pipelines,
- self-hosted agent setup,
- users/groups/permissions,
- original screenshots,
- current major refresh,
- screenshots being replaced,
- Amazon/KDP planned.
Avoid claiming until the final revision is complete:
- exact final page count,
- exact final Azure DevOps Server version,
- every cloud-only Azure DevOps feature,
- final publication date,
- final commercial title.
88. Final Portfolio Statement
I began this project in 2021 as a complete Persian-language guide to installing and operating Microsoft Azure DevOps Server locally. Rather than stopping at setup, the book walks through the platform feature by feature, including projects, Git repositories, Boards, Pipelines, permissions, administration, and self-hosted agents. The guide is built around original screenshot-by-screenshot documentation and currently spans approximately 400 pages. I am now rebuilding the walkthrough against the latest on-premises Azure DevOps Server release available from Microsoft, replacing outdated screenshots and revalidating the complete installation and usage flow before a final commercial edition planned for Amazon/KDP.
89. One-Line Summary
A ~400-page Persian visual guide to Azure DevOps Server, covering complete on-premises installation, administration, Repos, Boards, Pipelines, permissions, and self-hosted agents.
90. Ultra-Short Portfolio Label
Azure DevOps Server Persian Guide — On-Premises · CI/CD · Technical Authoring