Cum documentăm un ghid public în Pionier folosind imagini

Rezumat scurt

Includeți numai imagini publice sau permise pentru reutilizare, adăugați text alternativ (alt) și atribuiți sursa vizibil lângă imagine.

Pași practici

1. Verificați sursa și permisiunea:

• Confirmați că imaginea provine dintr-o sursă publică (de ex. un repository GitHub). Căutați fișiere de licență sau note de utilizare în aceeași sursă.

1. Pregătiți imaginea pentru ghid:

• Folosiți versiunea publică (linkul sau fișierul) fără a modifica conținut protejat, dacă licența nu permite modificări.

1. Adăugați imaginea în ghid:

• Includeți imaginea în corpul ghidului și asigurați-vă că are un text alternativ clar și descriptiv pentru accesibilitate.

1. Atribuiți sursa imediat lângă imagine:

• Afirmați explicit de unde provine imaginea (ex.: „Imagine preluată din documentația publică .NET Brand”).

1. Verificați licența și condițiile de reutilizare înainte de publicare:

• Dacă repo-ul sau fișierul conține restricții, respectați-le (menționați sursa, nu folosiți în scopuri comerciale dacă e restricționat, etc.). Dacă nu găsiți informații, cereți clarificări înainte de publicare.

Exemplu concret (format text/Markdown)

1. Inserare imagine (exemplu din conversație):

1. Text de atribuire imediat sub imagine:

Imagine preluată din documentația publică .NET Brand, utilizată pentru exemplificare. Sursă: https://github.com/dotnet/brand

Sfaturi practice

• Text alternativ: Scrieți un alt text scurt și util (de ex. „Logo .NET, culoare albastră, variantă principală”).
• Caption vs. atribuție: Caption pentru explicație; menționați sursa separat pentru transparență.
• Păstrați fișierele originale sau linkuri către sursă în metadatele ghidului pentru audit intern.

Limitări și avertismente

• Acest ghid oferă pași generali. Nu include instrucțiuni detaliate pentru interfața Pionier (de ex. butoanele sau meniurile specifice) deoarece transcriptul nu conține acele detalii. Consultați documentația internă Pionier pentru proceduri exacte de încărcare/înserare.
• Verificarea licenței rămâne responsabilitatea autorului ghidului: dacă repository-ul conține restricții, urmați cele specificate acolo.

Resurse menționate

• Exemplu sursă folosit în exemplu: https://github.com/dotnet/brand

Dacă doriți, pot adapta exemplul la un șablon Pionier (dacă îmi trimiteți pașii UI sau un export de șablon), sau pot sugera texturi alternative pentru alt-texte și atribuiri.