Co dalej ? - wstęp do ankiety.

[SOYER]

Brawo za takie podejście, zgadzam się z tym, że coś na kształt wiki w której wiele osób będzie się wypowiadać, bardzo szybko zmieni się w gęstwinę nie do przebycia. Potrzebna jest konkretna dokumentacja, to jest chyba ogrom pracy, ale to naprawdę konieczne jeśli supla ma się rozwijać. Poźniej trzeba utrzymywać zgodność tej dokumentacji z najnowszymi poprawkami, wersjami. Do tego musi być jedna osoba odpowiedzialna, za to rozliczana i nagradzana. Mówię tu też o dwóch wersjach językowych, nie miałbym nic przeciwko gdyby tą pierwszą była wersja angielska. Może jednak zacznijmy chociaż od PL.
Zróbcie to. Kto chętny?

[SOYER]

Nawet dyskusja w tym wątku wskazuje, że taka dokumentacja jest niezbędna.

[jaku2k]

@pzygmunt
Od kilku miesięcy myślę o wystartowaniu takiego Wiki (a bardziej wsparciu zasobami Wiki GUI Generica).

Wydaje mi się, że najpierw należy udokumentować GUI Generica, a potem Suplę. Można by najpierw napisać instrukcję, a potem do każdego działu robić osobny filmik (coś na kształt poradnika GUI Generic).
Mam już jakiś zarys, jak miałoby to wyglądać i działać. Niestety przytłoczyły mnie trochę rzeczy Suplowe (zrobiłem m.in. Suplowy sterownik oświetlenia na szynę DIN z LAN-em; jak rozwiążę problem z obsługą LAN-u, to chciałbym się nim podzielić). Jak się z tego odkopię (pewnie do końca roku), to wezmę się za pisanie.

Tak więc - przynajmniej na razie nikogo nie zatrudniajcie - zrobi się

[SOYER]

jaku2k, z całym szacunkiem i poważaniem do Twoich chęci i umiejętności. Nie zrozum mnie źle, może naprawdę jesteś idealnym kandydatem do tej roboty, ale to nie może być zrobione jako pospolite ruszenie, albo hobby jednego zapaleńca, który w wolnej chwili może coś kiedyś zrobi, a może nie. To musi być od początku do końca zrobione profesjonalnie i w miarę szybko. To nie może być robota na najbliższe 12-18 miesięcy. To jest robota ja wczoraj, ale profesjonalnie, merytorycznie, przy bliskiej współpracy z szanownymi Twórcami, przy ich pomocy ale też kontroli i ich wymaganiach. To nie może być ktoś za 30zeta na h.
Teraz to wygląda tak, że szukasz rozwiązania na forum, w którymś tam wątku jest coś opisane na dany temat na stronie 67, a po nieudanej próbie implementacji i założeniu kolejnego wątku, okazuje się, że owszem tamto rozwiązanie było dobre ale dla poprzedniej wersji czegoś tam, a teraz przecież to się robi zupełnie inaczej i jest to opisane w zupełnie innym temacie na której tam stronie wątku.
Nie chcę być źle zrozumiany, może się czepiam, ale uważam, że dobra dokumentacja to podstawa. Gdyby to był tylko system dla urządzeń wcześniej "prefabrykowanych", to ok. Jednak jeśli ma to być coś z czego ma wygodnie korzystać coraz większa liczba użytkowników, nie tylko w Polsce, to zapomnijcie na chwilę o implementacji geotaggingu, a zainwestujcie w dokumentację. Profesjonalną.
Filmiki, poradniki, tutoriale ok, później, może nawet na zasadzie społeczności, ale ostro moderowanej, jako, że mają to być oficjalne pomoce Supli. Jednak najpierw pisemna szczegółowa dokumentacja, co z czym i dlaczego.

[jaku2k]

jaku2k, z całym szacunkiem i poważaniem do Twoich chęci i umiejętności. Nie zrozum mnie źle, może naprawdę jesteś idealnym kandydatem do tej roboty, ale to nie może być zrobione jako pospolite ruszenie, albo hobby jednego zapaleńca, który w wolnej chwili może coś kiedyś zrobi, a może nie. To musi być od początku do końca zrobione profesjonalnie i w miarę szybko. To nie może być robota na najbliższe 12-18 miesięcy. To jest robota ja wczoraj, ale profesjonalnie, merytorycznie, przy bliskiej współpracy z szanownymi Twórcami, przy ich pomocy ale też kontroli i ich wymaganiach. To nie może być ktoś za 30zeta na h.
Teraz to wygląda tak, że szukasz rozwiązania na forum, w którymś tam wątku jest coś opisane na dany temat na stronie 67, a po nieudanej próbie implementacji i założeniu kolejnego wątku, okazuje się, że owszem tamto rozwiązanie było dobre ale dla poprzedniej wersji czegoś tam, a teraz przecież to się robi zupełnie inaczej i jest to opisane w zupełnie innym temacie na której tam stronie wątku.
Nie chcę być źle zrozumiany, może się czepiam, ale uważam, że dobra dokumentacja to podstawa. Gdyby to był tylko system dla urządzeń wcześniej "prefabrykowanych", to ok. Jednak jeśli ma to być coś z czego ma wygodnie korzystać coraz większa liczba użytkowników, nie tylko w Polsce, to zapomnijcie na chwilę o implementacji geotaggingu, a zainwestujcie w dokumentację. Profesjonalną.
Filmiki, poradniki, tutoriale ok, później, może nawet na zasadzie społeczności, ale ostro moderowanej, jako, że mają to być oficjalne pomoce Supli. Jednak najpierw pisemna szczegółowa dokumentacja, co z czym i dlaczego.

W pełni rozumiem Twoje rozterki. Uważam jednak, że jeśli włodarze Supli mają wydawać pieniądze, to lepiej żeby spożytkowali je na rozwój sensu stricto Supli, a nie jej dokumentację.

Zgadzam się z Tobą, że Supla potrzebuje dokumentacji. Nieskromnie wskażę na poradnik do GUI Generica, który - mniemam - jest zrobiony całkiem przyzwoicie. Marzy mi się taka dokumentacja dla całej Supli.

Kwestia też tego, co konkretnie rozumiesz przez dokumentację. Ja mam na myśli pakiet instrukcji wprowadzających początkujących użytkowników do systemu i korzystanie z narzędzi dla nowicjuszy (takich jak GG), a nie - udokumentowanie np. Supla-device.

[SOYER]

Co do tego co mam na myśli, to wydawało mi się, że wyraziłem się jasno. Kompletna dokumentacja. Podałem nawet przykład, dokumentacja Blynka. Moim zdaniem powinno tam być wszystko od a do z. Można by nawet wzorować się na strukturze tej dokumentacji. Supla nie jest, jeszcze, tak rozwiniętym i zaawansowanym projektem jak Blynk. Więc i pracy będzie mniej. Supla idzie swoją drogą. Szczerze życzę jej jak najlepiej. Jednak jak ma być profesjonalnie to trzeba o to zadbać.
Co do uwagi, że Twórcy powinni wydawać pieniądze na rozwój funkcjonalności Supli, a nie takie duperele jak jej dokumentacja, to kompletnie się z tym nie zgadzam.
Szanowni Twórcy zrobią jak uważają za stosowne, odniosłem wrażenie, po przeczytaniu wcześniejszych postów, że zdają sobie sprawę z konieczności zrobienia jakiejś dokumentacji.
Ja tylko proszę by nie była "jakaś", by było to zrobione kompleksowo i profesjonalnie.

[krycha88]

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

[jaku2k]

Co do tego co mam na myśli, to wydawało mi się, że wyraziłem się jasno. Kompletna dokumentacja. Podałem nawet przykład, dokumentacja Blynka. Moim zdaniem powinno tam być wszystko od a do z. Można by nawet wzorować się na strukturze tej dokumentacji. Supla nie jest, jeszcze, tak rozwiniętym i zaawansowanym projektem jak Blynk. Więc i pracy będzie mniej. Supla idzie swoją drogą. Szczerze życzę jej jak najlepiej. Jednak jak ma być profesjonalnie to trzeba o to zadbać.
Co do uwagi, że Twórcy powinni wydawać pieniądze na rozwój funkcjonalności Supli, a nie takie duperele jak jej dokumentacja, to kompletnie się z tym nie zgadzam.
Szanowni Twórcy zrobią jak uważają za stosowne, odniosłem wrażenie, po przeczytaniu wcześniejszych postów, że zdają sobie sprawę z konieczności zrobienia jakiejś dokumentacji.
Ja tylko proszę by nie była "jakaś", by było to zrobione kompleksowo i profesjonalnie.

Bynajmniej nie zaliczam dokumentacji do grupy dupereli

Po prostu uważam, że lepiej, aby Supla zyskała choć trochę więcej funkcjonalności, by mogła konkurować z innymi rozwiązaniami Smart home (sceny są tutaj Wielkim skokiem naprzód; uważam jednak, że brakuje jej trochę do konkurencji - chociażby poruszane kilka postów wyżej wsparcie dla adresowalnych LED-ów). Myślę, że brak dokumentacji nie odstrasza tak bardzo, jak brak chociażby logiki. Powtórzę: myślę - a więc mogę się mylić.

Co do profesjonalności - nie wiem, co przez to dokładnie rozumiesz. Jeśli chodzi Ci o interfejs graficzny, to w dzisiejszych czasach to raczej bułka z masłem - na rynku jest wiele gotowych rozwiązań. Wspomniana przez Ciebie dokumentacja Blynka jest chyba na GitBooku - dokumentacja GG korzysta z Grava, mnie podoba się Vue Press...

Ale nie wyprzedzajmy faktów i zostawmy skórę tego niedźwiedzia W końcu jeszcze nic nie powstało - fajnie, że ten problem wybrzmiał.

[SOYER]

krycha88, tak, oficjalnie zgłaszam ten pomysł.
jaku2k, piszeż, że brakuje Ci obsługi jakiś tam LEDów. Ja jako nowy użytkownik Supli nie wiem, czy ona w ogóle obsługuje np ledy programowalne. Jeśli tak to nie wiem jak to zrobić. Nie wiem gdzie szukać tych informacji. Na forum? Serio? Wpisać w wyszukiwarkę, znaleźć jakiś temat, przeglądnąć ileś stron tego tematu? Sprawdzać kiedy to było napisane i trzymać kciuki by nadal było aktualne? Szukać na githubie, ja coś tam znajdę, z naciskiem na słowo "coś". Co ma powiedzieć kompletnie zielony nowy user?
To nie tak powinno wyglądać.
Dla starych wyjadaczy na forum też łatwiej będzie młodemu wysłać link do konkretnego fragmentu dokumentacji i napisać " tu masz jak to trzeba zrobić, jak Ci nie wyjdzie wklej kod z tym co zrobiłeś, a my postaramy się pomóc".
Pozdrawiam i proszę też o kanał ogólnego przeznaczenia.

[LukaszH]

Nie wiem czy nie mylicie komercyjnych urządzeń które mają Suple jako oprogramowanie tak jak produkty Zamela, z otwartą strykturą Supli i udostępnienia serwerów dla hobbystów ? Projekt GUI Generic powstał na forum jako DIY ale jest tak dobry że trafił na oficjalne strony i ma chyba tysiące użytkowników za co trzeba podziękować twórcom - są odpowiednie formy;) Produkty komercyjne mają dosyć szczegółowe instrukcje i sprowadzają się do konkretnych zastosowań. I tak fajnie że Twórcy Supli dali taką mnogość zastosowań do projektów DIY ale tworzenie dokumentacji ze wszystkiego co stworzyła społeczność wydaje się kłopotliwa. Tak czy owak będzie ankieta i będziemy mogli oddać głos co ponownie super ukłon do społeczności Supla, a osoby jak @jaku2k jeśli pomogą to uważam że fajnie i trzymam kciuki !