13 odpowiedzi w tym temacie

[GT Team]

Przydalo by sie posegregowac troche dokumentacje.
Tutaj opisalem tak troche

Ogolnie chodzi oo calosc.

http://imageshack.us...ztytuuocoo.png/

[MarWit]

Można byłoby dodać alternatywną metodę sortowania, jednak tą ( czyli sort by filename ) bym zostawił jako główną. Co jak co, ale szukanie funkcji po nazwie pliku nagłówkowego jest szybsze niż przedzieranie się przez masę kategorii.

[GT Team]

No to jak ?
Widzę, że chyba olewacie sprawe

Użytkownik PaTrIcKx edytował ten post 28.10.2012 16:33

[GwynBleidD]

Proponuję również zmienić edytor propozycji, aby domyślnie wypełniał się kodem, który jest wyświetlany, a nie jakimś domyślnym tekstem opisującym funkcję o nazwie "funkcja" Albo zamiast jednego dużego edytora dodać kilka małych pól do wypełnienia odpowiednich sekcji w dokumentacji.

[GT Team]

No, dziękuję za poświęcony czas. Teraz o wiele lepiej, nie bd zamykać tematu, gdyż widzę, że składane są tutaj inne propozycje.

[Fili:P]

Według mnie pomysł bardzo ciekawy i świetne realizacja benia

Ciesze się że ludzie proponują takie dobre pomysły i naprawdę według mnie przydatne. Na pewno to jakaś zmiana na lepsze. Czuje się że coś na forum się dzieje i idziemy w górę

 

Jak mówiłem pomysł bardzo przydatny i jak widać w wykonaniu estetyczny. Gratulacje.

[GT Team]

Tylko teraz przydał by się Podgląd tworzenia nowego opisu .

[GT Team]

I to się nazywa Administrator. Temat uważam za wyczerpany stukroć.

A jednak widać przydało by się zmienić to:

 

a dokładniej widzę w żółtym tle

Moderacja

 

przydało by się zlikwidować to dla zwykłych użytkowników

[GwynBleidD]

Propozycje: stworzyć strukturę jednolitą dla każdej funkcji, przedstawię to w formie pliku XML:

<function name="parse" type="native">
    <param name="text" array="true" type="const">tekst zawierający parametry</param>
    <params type="">dalsze argumenty występują parami: [sma] {...}</params>
    <notice>Każda dodana para to dla funkcji sygnał do wyszukanie kolejnego parametru.</notice>
    <return type="">Funkcja zwraca ilość parametrów, które udało się uzyskać</return>
    <example>new a[20], b[15], c[32]; ...</example>
    <warning></warning>
</function>

Oczywiście jest to przykład samej strukturyzacji opisu. Nie chodzi mi tu o użycie XML do przechowywania, czy wyświetlania danych (chociaż możliwość eksportu do XMLa byłaby przydatna). Po prostu użytkownik edytujący taką dokumentację, zamiast opisu całego będzie miał do wpisania w odpowiednie pola opisu odpowiednich wartości, wpisanie uwag itp. Ujednolici to wygląd każdej ze stron opisu funkcji (jak wiemy, wyglądają one różnie...). Oczywiście wymagałoby to przeparsowania danych tekstowych, które są teraz w dokumientacji, na odpowiednie pola. Ale moim zdaniem ma to sens

 

[GwynBleidD]

Jako taki schemat samych danych nie musi być stricte taki, jak zaprezentowałem oczywiście chodzi o samą ideę. A jeśli mowa o samym przeniesieniu danych: kilka wyrażeń regularnych i można to dość dobrze zautomatyzować.