Co dalej ? - wstęp do ankiety.

[Robert Błaszczak]

Szanowni, temat wątku dotyczy nowych funkcjonalności po stronie serwera i aplikacji Supla. Z dokumentacją nie ma to nic wspólnego. Oczywiście powstanie WIKI jak najbardziej popieram, ale to nie ten temat, jak już @krycha88 wcześniej napisał.

[Albert]

Dokładnie popieram.

Marnowanie czasu i środków na pisanie jakichś bezsensownych dokumentacji jest teraz niepotrzebne.

kolega @jaku2k zaoferował się, że coś będzie w tej materii ogarniał, zatem nie widzę powodu aby go od razu "niszczyć" z jego pomysłem.

Wszystko co niezbędne teoretycznie jest na forum i jak ktoś się bierze za jakieś DIY powinien potrafić korzystać z wyszukiwarki. Bynajmniej ja nie mam z tym żadnego problemu, a jeśli nawet to da się zapytać i zawsze znajdzie się ktoś, kto podpowie. Nie oszukujmy się, ale osób piszących samodzielnie kod jest garstka, a większość korzysta z gotowców jak mistrzowski GG, gdzie sie tylko "klika" co się chce. Także ja jestem zdecydowanie przeciwny marnowaniu teraz czasu i środków na pisanie instrukcji

[Albert]

Czyli do ankiety chcecie dopisać punkt "Kompletna dokumentacja" ?

Zdecydowanie nie

[klew]

Dokumentacja to nie jest prosty temat. Wg mnie tego nie da się tak po prostu zlecić i niech ktoś to napisze. Możnaby pisać dokumentacje na bazie jakiejś specyfikacji, ale tego też nie ma

W ostatnim roku mieliśmy przejściowo kilka osób zajmujących się projektem grafiki. W większości byli to graficy, którzy wcześniej z Suplą nie mieli styczności. Już samo wytłumaczenie czego oczekujemy od projektu graficznego było dość mocno problematyczne, bo te osoby nie znały i nie używały Supli na codzień. Podobnie próba zlecenia napisania dokumentacji mogłaby być trudna, bo to może być napisane wyłącznie przez osoby znające dogłębnie temat.

Wbrew pozorom to nie jest tak, że dokumentacji Supli nie ma. Wiele rzeczy jest opisanych, tylko jest to w różnych miejscach i ciężko takie rzeczy odnaleźć.

Supli na pewno przydałby się taki ogólny "wstęp do Supli", gdzie są przedstawione główne koncepcje, opisane komponenty oprogramowania itd.

Kolejny temat to utrzymanie takiej dokumentacji. Tak naprawdę to im większa baza tekstu, tym trudniej ją utrzymać. To trzeba regularnie przeglądać i aktualizować.

Temat "dokumentacja' nie wyląduje w propozycjach nowych funkcjonalności ani dla Clouda ani dla apek mobilnych, bo nie taki jest cel tych ankiet. Natomiast ja ze swojej strony postaram się trochę nadrobić zaległości w dokumentacji i przykładach dla SuplaDevice. Fajnie, że powstał opis/dokumentacja do Gui Generic. Do tego przydałoby się zrobić jakąś dokumentację do komercyjnych produktów z opisem co robią które opcje w ustawieniach i "dział urządzeń wykonawczych" byłby mniej więcej opisany.

[SOYER]

"Dokumentacja to nie jest prosty temat", na pewno.
"na bazie jakiejś specyfikacji, ale tego też nie ma" nie wiedziałem.
"Wiele rzeczy jest opisanych, tylko jest to w różnych miejscach i ciężko takie rzeczy odnaleźć", a jak już znajdziesz to jeszcze zapytaj czy to aktualne.
"Supli na pewno przydałby się taki ogólny "wstęp do Supli", gdzie są przedstawione główne koncepcje, opisane komponenty oprogramowania itd", racja.
"Kolejny temat to utrzymanie takiej dokumentacji. Tak naprawdę to im większa baza tekstu, tym trudniej ją utrzymać. To trzeba regularnie przeglądać i aktualizować", to chyba oczywiste jest.
"Temat "dokumentacja' nie wyląduje w propozycjach nowych funkcjonalności ani dla Clouda ani dla apek mobilnych, bo nie taki jest cel tych ankiet" , pełna zgoda.
Czyli plan jest taki by na razie Suplę rozwijać przede wszystkim jako soft dla gotowych urządzeń. Userów takich jak Ci z tego forum traktujemy na zasadzie, poszukaj, zapytaj, jakoś sobie poradzisz. Jasne, że sobie poradzimy, po to jest to forum.
Ja takie podejście akceptuję, choć wcale mie rozumiem takiego podejścia do wykonywanej pracy.
Piszecie o tym jak trudno komuś z zewnątrz wytłumaczyć coś o szacie graficznej supli. To teraz wyobraźcie sobie jak ja tłumaczę szwagrowi co to supla, supla cloud, supla scripts i supla gui generic. Jak mu tłumaczę, że o tym ma poczytać tu, a dopytać tam, o tamtym ma poczytać jeszcze gdzieś, a dopytać tutaj, a o kolejnej rzeczy dowie się z YT.
Jak napisałem, przyjmuję do wiadomości, ale nie rozumiem. Zapewne miałbym inne podejście gdybym był instalatorem gotowych modułów, ale czy na pewno?

[SOYER]

Albert piszesz :"Marnowanie czasu i środków na pisanie jakichś bezsensownych dokumentacji jest teraz niepotrzebne", a kiedy Twoim zdaniem będzie odpowiednia chwila? Chciałbym to od Ciebie usłyszeć.