Tracker/pl



FreeCAD BugTracker jest miejscem, na którym to możnaː zgłaszać błędy, przesyłać prośby o funkcje, poprawki lub prośby o połączenie oddziału, jeśli opracowałeś coś przy użyciu Gita. Tracker jest podzielony na Środowiska pracy, więc proszę być konkretnym i złożyć wniosek w odpowiedniej podsekcji. W razie wątpliwości należy pozostawić go w sekcji FreeCAD.

Zalecany przepływ pracy


Jak pokazano na powyższym schemacie, przed utworzeniem zgłoszenia należy zawsze najpierw przeszukać forum i bugtracker, aby dowiedzieć się, czy Twój problem jest znany. Oszczędza to mnóstwo czasu/ pracy dla programistów i wolontariuszy, którzy mogliby poświęcić ten czas czyniąc FreeCAD jeszcze bardziej niesamowitym.

Zgłaszanie błędów
Jeśli uważasz, że mogłeś znaleźć błąd, możesz go zgłosić, pod warunkiem, że postępowałeś zgodnie z naszymi zasadami krok po krokuː


 * Upewnij się, że używasz najbardziej aktualnej wersji FreeCAD. UWAGAː. Twój błąd może zostać naprawiony w wersji rozwojowej (niestabilnej). Zwykle użytkownicy korzystają z wersji stabilnej FC.
 * Upewnij się, że twój błąd jest naprawdę błędem, to znaczy czymś, co powinno działać, ale nie działa. Upewnij się, że ten sam błąd nie został wcześniej zgłoszony, poprzez wstępne przeszukanie bugtrackera i forum.
 * Pamiętaj, żeː jeśli nie jesteś pewien, nie wahaj się wyjaśnić swojego problemu/błędu na Forum Pomocy i zapytaj co robić.
 * Uwagaː przed wysłaniem postu na forum proszę przeczytać Przewodnik po forum.
 * Opisuj jak najdokładniej problem, i jak można go odtworzyć. Jeśli nie możemy zweryfikować błędu, możemy nie być w stanie go naprawić.
 * Oznacza to zgłaszanie w sposób jasny, dobrze sformatowany, krok po kroku, aby nawet użytkownik amator mógł go odtworzyć.
 * Zalecamyː załączać Zrzuty ekranu błędu, są również bardzo pomocne. Użytkownicy Windows: proszę nie dołączać zrzutów ekranu w formacie Word lub PDF. Użyj narzędzia Windows Snipping do zapisania zrzutu jako obrazu PNG.
 * Zalecamyː Jeszcze lepszym będzie, "Animowany gif lub Screencast" zwiększyłby prawdopodobieństwo udanego powielenia problemu.
 * Dodaj przykładowy plik FreeCAD (.FCStd), aby programiści/testerzy mogli szybko odtworzyć błąd.
 * Proszę nie pakować pliku *.FCStd, jest już skompresowany.
 * Załączniki są ograniczone rozmiarem. Jeśli Twój plik *.FCStd jest zbyt duży, aby go załączyć, możesz skorzystać z usługi dysku online (wiele z nich jest darmowych jak Google Drive, Microsoft OneDrive, Dropbox).
 * Dołącz wszystkie informacje zawarte w oknie dialogowym Pomoc (menu) -> O programie FreeCAD, używając w przycisku . Upewnij się, że twoje dane zawierają używaną wersję OCC lub OCE.
 * Proszę złożyć jeden osobny raport dla każdego błędu.
 * Jeśli twój błąd powoduje awarię programu FreeCAD i jesteś w systemie, który go obsługuje, możesz spróbować uruchomić debug backtrace i dołączyć ten ślad do zgłoszenia. To może zaoszczędzić programistom dużo czasu przez wskazywanie źródła błędu. Zobacz Debugging po więcej szczegółów.

Oczekiwane funkcje
Jeśli chcesz, aby w FreeCAD pojawiło się coś, co nie jest jeszcze zaimplementowane, to nie jest błędem, ale żądaniem funkcji.


 * 1) WAŻNEː Przed złożeniem zapytania o potencjalną funkcję upewnij się, że jesteś pierwszy, przeszukując forum i bugtracker. Jeśli doszedłeś do wniosku, że nie istnieją wcześniejsze zgłoszenia lub dyskusje, następnym krokiem jest toː
 * 2) Utwórz wątek na forum, aby przedyskutować swoją prośbę o funkcje ze społecznością poprzez forum.
 * 3) Gdy społeczność zgodzi się, że jest to ważna funkcja, możesz otworzyć zgłoszenie na trackerze (wpisz je pod żądanie funkcji zamiast błąd).
 * UWAGA #1 Aby zachować porządek, należy pamiętać o umieszczeniu adresu URL zgłoszenia w wątku forum, oraz numeru zgłoszenia (jako linku).
 * UWAGA #2 Pamiętaj, że nie ma gwarancji, że twoje życzenie zostanie spełnione. MantisBT-setting-Feature-Request.jpg

Przesyłanie łatek
Jeśli zaprogramowałeś poprawkę dotyczącą błędu, rozszerzenie lub coś innego, co może być użyteczne publicznie w programie FreeCADe, stwórz łatkę używając narzędzia Git diff i prześlij ją na tym samym trackerze (zapisz ją jako łatkę).

Uzupełnienieː Rozwijanie programu FreeCAD zostało oparte na modelu GitHub, więc przepływ pracy przy przesyłaniu łatek został znacznie ulepszony i uzupełniony poprzez przesyłanie Pull Requests. UWAGA:, społeczność FreeCAD zaleca, aby najpierw przedyskutować każdą dużą zmianę kodu źródłowego, w celu oszczędności czasu.
 * 1) Otwórz wątek na forum, w podforum dewelopera, aby ogłosić i omówić swój patch.
 * 2) Wyślij swój Pull Request (PR) do FreeCAD repozytorium GitHub. Upewnij się, że połączyłeś wątek forum z podsumowaniem git commit. Jeśli nie pracowałeś wcześniej z  lub nie jesteś zaznajomiony z wysyłaniem PR na Github, przeczytaj nasze wprowadzenie do Github na stronie wiki.
 * 3) Wklej link PR do wątku forum dla testerów deweloperów.
 * 4) Bądź obecny podczas dyskusji, aby Twój kod mógł być potencjalnie efektywniej połączony.

Wnioskowanie o połączenie
(Te same wytyczne co Przesyłanie łatek).

Jeśli stworzyłeś gałąź gita zawierającą zmiany, które chciałbyś zobaczyć w kodzie FreeCAD, możesz tam poprosić o recenzję i połączenie swojej gałęzi, jeśli deweloperzy FreeCAD są wobec niej zgodni. Musisz najpierw opublikować swoją gałąź w publicznym repozytorium git (github, gitlab, bitbucket, sourceforge itp...), a następnie podać adres URL Twojej gałęzi w swoim wniosku o połączenie.

Znacznik MantisBT
MantisBT (Mantis Bug Tracker) ma swój własny unikalny znacznik.
 * @ Wspomniany - działa tak jak na GitHubie, gdzie jeśli wyślesz na czyjąś nazwę użytkownika, osoba ta otrzyma powiadomienie email, że została wymieniona w wątku zgłoszenia.
 * #1234 - Poprzez dodanie znaku przed numerem pojawi się skrót do połączenia z innym zgłoszeniem w MantisBT.
 * Uwaga: jeśli najedziesz kursorem na zgłoszenie, wyświetli się podsumowanie + jeśli bilet jest zamknięty, zostanie przekreślony jak # 1234.
 * ~5678 - skrót, który łączy się z notatką o błędzie w zgłoszeniu. Może być użyty do odniesienia się do czyjejś odpowiedzi w obrębie wątku. Każda osoba, która umieściła zgłoszenie, będzie miała przy swojej nazwie użytkownika wyświetlony unikalny numer ~#####. Jeśli spojrzysz na obrazek w przykładzie, zobaczysz, że skrót odnosi się do numeru zgłoszenia:numeru komentarza tego zgłoszenia.
 *   - Te tagi będą przekreślać tekst.
 *    - Aby przedstawić linię lub blok kodu, użyj tego znacznika, a on pokoloruje i elegancko go wyróżni.

MantisBT BBCode
Oprócz powyższego Znaczniki MantisBT istnieje również możliwość korzystania z formatu BBCode. Pełna lista znajduje się na stronie BBCode plus strona z pluginami. Poniżej znajduje się lista obsługiwanych formatów BBCodeː

MantisBT <=> znaczniki GitHub
Poniżej znajdują się specjalne słowa kluczowe pluginu MantisBT Source-Integration, który łączy się z repo FreeCAD GitHub. Zobacz GitHub oraz MantisBT.
 * c:FreeCAD:git commit hash: - c oznacza commit. FreeCAD oznacza GitHub FreeCAD repo. git commit hash to konkretny skrót git commit, do którego nastąpiło odwołanie. Uwaga: konieczne jest użycie dwukropka wskazującego. Przykładː
 * d:FreeCAD:git commit hash: - podobny do powyższego, d oznacza "diff", co zapewni odmienny pogląd na temat danego zobowiązania. Przykładː
 * p:FreeCAD:pullrequest: - podobny do powyższego, p oznacza Pull Request. Przykładː

GitHub oraz MantisBT
FreeCAD bugtracker posiada wtyczkę o nazwie Source Integration, która zasadniczo wiąże oba FreeCAD GitHub repo z naszym trackerem MantisBT. Ułatwia to śledzenie i kojarzenie zgłoszeń git z ich odpowiednimi zgłoszeniami do MantisBT. Plugin Source Integration skanuje komunikaty git commit w poszukiwaniu konkretnych słów kluczowych w celu wykonania następujących działań:.

Uwaga Poniższe słowa kluczowe muszą być dodane w git commit message, a nie w temacie PR.

Zdalne odwoływanie się do zgłoszenia.
Użycie tego wzorca automatycznie połączy git commit do zgłoszenia (Uwaga: to nie zamknie zgłoszenia). Format MantisBT rozpozna: Dla dociekliwych tutaj jest wyrażenie regularne, którego używa MantisBT do tej operacji:
 * bug #1234
 * bugs #1234, #5678
 * issue #1234
 * issues #1234, #5678
 * report #1234
 * reports #1234, #5678

Rozwiązywanie zdalnie zgłoszeń
Interfejs MantisBT rozpoznaje format: Dla dociekliwych: mamy tu zastosowanie wyrażenia regularnego MantisBT do tej operacji:
 * fix #1234
 * fixed #1234
 * fixes #1234
 * fixed #1234, #5678
 * fixes #1234, #5678
 * resolve #1234
 * resolved #1234
 * resolves #1234
 * resolved #1234, #5678
 * resolves #1234, #5678

Powiązane

 * Usuwanie błędów
 * Zarządzanie kodem źródłowym