Tutorial pentru scrierea articolelor

Ne bucuram ca ai ajuns aici si vrei sa contribui la continutul educational al site-ului. Aceasta pagina se vrea un ghid rapid si eficient care sa te puna la treaba. Poti sa citesti inainte si despre Textile si conventiile de formatare pe care le utilizam, dar crearea unui articol este mult mai simpla si mai frumoasa decat acele seturi de reguli. :)

Structura articolului

Mai mult ca sigur ca ai un plan pe care vrei sa-l urmezi in scrierea articolului. Punerea lui pe infoarena este cu atat mai simpla. Tot ce trebuie sa faci este sa copii continutul paginii "Structura articol" in pagina articolului tau, iar apoi sa il adaptezi in functie de titlul, categoria si sectiunile adecvate. Dupa cum observi in structura, e foarte important sa ai un cuprins care sa-i ajute pe utilizatori sa se duca direct la tinta in articol.
Referitor la structura, iti facem si cateva recomandari care vor pune in valoare munca ta:

  • Mentine sectiunile de cel mult 1 pagina pentru a fi usor de urmarit.
  • Propune-i cititorului o lista de probleme care il pot ajuta in intelegerea subiectului abordat.
  • Include la sfarsit si o lista bibliografica cu sursele din care te-ai documentat.

Bucati de cod

Daca subiectul pe care il tratezi necesita si implementari intr-un limbaj de programare, nu ezita sa incluzi bucati de cod edificatoare. Iata un exemplu despre cum ar trebui sa arate codul pe care il incluzi:

const int MAX_N = 100;

int N, A[MAX_N], B[MAX_N];

void merge_sort(int l, int r) {
    int m = (l + r) >> 1, i, j, k;
    if(l == r) return;

    merge_sort(l, m);
    merge_sort(m + 1, r);

    for(i = l, j = m + 1, k = l; i <= m || j <= r; )
        if(j > r || (i <= m && A[i] < A[j]))
            B[k++] = A[i++];
        else
            B[k++] = A[j++];

    for(k = l; k <= r; k++)
        A[k] = B[k];
}

Ce trebuie sa observi la el?

  • numele de variabile si de functii sunt sugestive
  • indentarea se face cu 4 spatii, nu tab-uri
  • se evita macro-urile, folosind in schimb constante, typedef, functii inline
  • codul este aerisit prin separarea cu spatii a operatorilor de restul codului (mai putin ++ si --)
  • codul compileaza pe o versiune recenta a unui compilator modern

Formule

Daca articolul tau necesita formule mai complicate, nu te lasa descurajat. Infoarena suporta \LaTeX. Si ca sa-ti trezim un pic apetitul si sa iti placa sa lucrezi la articolul tau, iata ce se poate face:

infoarena = \displaystyle\sum_{user=1}^\infty implicare_{user}

Alte aspecte

Speram ca munca la articole sa fie simpla si placuta. Daca totusi te incurci in site-ul nostru, ia legatura cu unul din membrii echipei infoarena si o sa fii indrumat. Spor la treaba!