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

Submitting patches
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ę).

Addendumː FreeCAD development has switched to the GitHub development model so the workflow for submitting patches has been greatly enhanced/streamlined by submitting Pull Requests. NOTEː the FreeCAD community recommends to first discuss any large revision to the source code in advance to save everyone time.
 * Open a forum thread in the Developer subforum to announce and discuss your patch.
 * Submit your PR to the FreeCAD GitHub repo. Be sure to link the forum thread in to the git commit summary.
 * Paste the PR link in to the forum thread for the devs/testers to test.
 * Be present for the discussion so that your code can potentially be merged more effectively.

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.

MantisBT Markup
MantisBT (Mantis Bug Tracker) has it's own unique markup.
 * @mention - works just like on GitHub where if you prepend '@' to someone's username they will receive an email that they have been 'mentioned' in a ticket thread
 * #1234 - By adding a hash tag in front of a number a shortcut to link to another ticket within MantisBT will present.
 * Note: if you hover over a ticket it will show you the summary + if the ticket is closed, it will be struck-through like #1234.
 * ~5678 - a shortcut that links to a bug note within a ticket. This can be used to reference someone's response within the thread. Each person that posts will show a unique ~#### number next to their username. If you look at the image in the example, you see that the shortcut is referencing the ticket number:comment number of said ticket
 *   - Using these tags will strikeout text.

MantisBT <=> GitHub Markup
Below are special MantisBT Source-Integration plugin keywords which will link to the FreeCAD GitHub repo. See Tracker.
 * c:FreeCAD:git commit hash: - c stands for 'commit'. FreeCAD stands for the FreeCAD GitHub repo. 'git commit hash' is the specific git commit hash to reference. Note: the trailing colon is necessary. Exampleː
 * d:FreeCAD:git commit hash: - similar to the above, d stands for 'diff' which will provide a Diff view of the commit. Exampleː
 * p:FreeCAD:pullrequest: - similar to the above, p stands for Pull Request. Exampleː

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

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