Markdown content direct included in the page

Stable

HEADS UP!!!
LINKS TO OTHER SITE DOCS MUST BE GIVEN USING THE PERMALINKS, NOT THE FILE NAME

Link to file in different folder

broken link

good external link

broken external link

HEADS UP!!!!
- Liquid tags may generate unexpected behaviour sometimes due to dry rendering during site build.
- Dry rendering is used in the site build process to generate related pages and keywords
- It may be possible to have the front matter rendered also

using site vars from siteConfig: xxx

Markdown content generated from one part of another site page

📚 Introducere

Bine ai venit la DOCAROO — resursa ta completă pentru a învăța cum să creezi, construiești și întreții site-uri de documentație de înaltă calitate pentru orice tip de proiect, produs sau organizație.

Fie că ești un dezvoltator independent, un redactor tehnic, un contribuitor open-source, o echipă de startup sau un strateg de conținut într-o companie mare, acest ghid te va ghida pas cu pas pentru a construi un site de documentație complet, profesionist și ușor de întreținut.

🚀 Ce este acest ghid?

Acest ghid este un manual pas cu pas care explică:

Cum să planifici, structurezi și organizezi documentația
Cum să alegi instrumentele și tehnologiile potrivite
Cum să construiești un site de documentație complet funcțional
Cum să redactezi conținut clar, centrat pe utilizator
Cum să stilizezi și personalizezi site-ul pentru branding
Cum să publici și să întreții eficient site-ul

📌 Cui i se adresează?

Acest ghid este potrivit pentru:

Dezvoltatori care doresc să documenteze API-uri, biblioteci sau framework-uri
Echipe de produs care creează documentație internă sau pentru clienți
Redactori tehnici care vor să îmbunătățească structura și claritatea
Administratorii de proiecte open-source care creează ghiduri de onboarding
Educatori și formatori care documentează tutoriale sau cursuri
Oricine dorește să creeze o bază de cunoștințe sau un centru de asistență

Nu este necesară experiență anterioară cu sisteme de documentație — începem de la bază și construim progresiv.

🧱 Ce vei învăța?

La finalul acestui ghid, vei înțelege:

1. Strategia documentației

Cum să identifici publicul țintă
Cum să structurezi tipurile de conținut: tutoriale, referințe, întrebări frecvente etc.
Cum să stabilești obiective pentru descoperire și utilizabilitate

2. Instrumente și Framework-uri

Prezentarea generatorilor de site-uri statice (ex: Docusaurus, MkDocs, VuePress)
Cele mai bune practici pentru Markdown
Controlul versiunilor cu Git
Alegerea platformei de publicare (ex: GitHub Pages, Netlify, Vercel)

3. Arhitectura site-ului

Structura folderelor și organizarea conținutului
Proiectarea meniului lateral și a navigației
Configurarea căutării și indexării

4. Scrierea și stilul conținutului

Principii de redactare clară
Coerența terminologiei
Formatarea codului și adnotările
Considerații privind accesibilitatea

5. Tematizare și personalizare

Branduirea documentației tale
Adăugarea de stiluri și pluginuri personalizate
Crearea de componente reutilizabile

6. Publicare și întreținere

Publicare continuă (CI/CD)
Versionare și jurnale de schimbări
Contribuții din comunitate
Menținerea documentației actualizate

🛠️ Cerințe preliminare

Pentru a urma acest ghid, vei avea nevoie de:

Cunoștințe de bază despre Git și GitHub (sau alt VCS similar)
Familiaritate cu sintaxa Markdown
Un mediu de dezvoltare (recomandat: Node.js)
Acces la un browser și un editor de text (ex: VS Code)

📁 Ce conține această documentație?

Site-ul este împărțit în secțiuni logice, fiecare construind pe baza celei anterioare:

Începe aici – Prezentare generală, obiective și configurarea uneltelor
Planificarea documentației – Analiza publicului, ierarhia conținutului și tipuri de documentație
Construirea site-ului – Instalare, configurare și rulare a framework-ului de documentație
Scrierea documentației eficiente – Sfaturi, formatare, structură și coerență
Personalizare – Layout, teme, identitate vizuală și elemente interactive
Publicare – Găzduire, CI/CD, versionare și analiză
Cele mai bune practici – Accesibilitate, localizare, SEO și procese de întreținere
Exemple și șabloane – Proiecte de pornire, fragmente reutilizabile și machete de conținut

🧭 De ce este importantă documentația?

Documentația bine scrisă este mai mult decât un simplu manual de utilizare:

Ajută utilizatorii să înțeleagă și să folosească produsul tău
Reduce volumul solicitărilor de suport și timpul de onboarding
Creează încredere, credibilitate și comunitate
Permite colaborarea și contribuția externă
Păstrează cunoștințele instituționale

O documentație bună nu este doar un bonus — este o componentă esențială a succesului produsului.

✅ Să începem!

Folosește meniul lateral pentru a naviga la prima secțiune și a începe călătoria. Fiecare subiect include exemple, șabloane și sfaturi practice din lumea reală pentru a te ajuta să treci de la o pagină goală la o documentație completă.

Markdown content generated from a file from a collection. This file has its own content but loads external content too.

General

This is a file from a collection

External content

This file loads some external content from another repo and place it inline.

Link to file in different folder

Markdown content generated from one part a partial which is not a site page

partial 1

h2 from partial md file

I am a paragraph from a partial file under a h2 title. The h2 title will be placed in ToC under the first h1 found in the document above this h2 title.

h1 from partial file

I am a paragraph from a partial file under a h1 title. The h1 title will be placed on the 1st level of Toc.