Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Propozycja nazewnictwa watkow #152

Open
telotony opened this issue May 16, 2023 · 2 comments
Open

Propozycja nazewnictwa watkow #152

telotony opened this issue May 16, 2023 · 2 comments
Labels
techniczne Technikalia, a nie merytoryka

Comments

@telotony
Copy link

telotony commented May 16, 2023

1). Proponuje dla przejrzystości przyjąć jakiś sposób nazewnictwa wątków, aby było to jasne, bo w wielu wątkach pojawiają się podobne argumenty i te same ulgi.

Proponuje przyjąć nazewnictwo
[Par. Nr / ust. Nr / pkt. Nr ] nazwa zmiany

nazwa zmiany - krótkie w 3-5 słowach wyjaśnienie propozycji zmiany.

2). Może byśmy jakieś głosowania też przeprowadzili nad konkluzjami z poszczególnych wątków?

@piotr-calus
Copy link

piotr-calus commented May 16, 2023

Proponuje przyjąć nazewnictwo [Par. Nr / ust. Nr / pkt. Nr ] nazwa zmiany
Przydała by się jeszcze informacja o tym, której ustawy dotyczy wątek.

Warto pamiętać, że zawartość ustaw będzie się jeszcze zmieniała więc zalecane jest precyzyjne odnoszenie się do komentowanej wersji. Można to zrobić na kilka sposobów...

Odniesienie się do wersji pliku PDF

Np. v1.0. Wadą jest fakt, że wersje PDF będą aktualizowane rzadziej niż pliki tekstowe (.md). Tym samym zawsze warto sprawdzić, czy komentowana treść nie została już zmieniona w pliku tekstowm w głównej gałęzi (main).

Podanie rewizji pliku tekstowego (.md)

Oznaczenie rewizji można znaleźć w historii. Wystarczające jest podanie wersji skróconej, np. 2bacaff. Wersję pełną można skopiować klikając na przycisk z lewej strony numeru rewizji. Po najechaniu pojawia się opis w "chmurce": Copy the full SHA, a sam identyfikator wersji, po wklejeniu, może wyglądać następująco: 2bacaff4c945dca367d6b735b9698b618d59c6f0. Po zapisaniu pola tekstowego widoczny jest taki sam odnośnik jak przy wersji skróconej, więc nie należy przejmować się długością tekstu.

Wklejenie odnośnika do konkretnego zakresu linii z pliku tekstowego (.md)

W trybie podglądu wybranego pliku, należy wcisnąć przycisk Code (między Preview, a Blame). Należy kliknąć na numer linii początkowej, a następnie przytrzymać na klawiaturze Shift i kliknąć numer linii końcowej. W lewej strony oznaczonego zakresu pojawi się przycisk z trzema kropkami .... Po kliknięciu na niego i Copy permalink należy wkelić odnośnik ze schowka do tworzonego zgłoszenia/komentarza. Zakres linii podany jest na końcu odnośnika więc w razie potrzeby można go skorygować ręcznie.

Np. gałąź main > wersje tekstowe/PIT dla zatrudnionych - ustawa.md > Code

Odnośnik zawiera wszystkie informacje do określonej linii w konkretnej rewizji i może wyglądać następująco:

https://github.com/ProjektyUstaw/Ustawy-o-PIT/blob/2bacaff4c945dca367d6b735b9698b618d59c6f0/wersje%20tekstowe/PIT%20dla%20zatrudnionych%20-%20ustawa.md?plain=1#L36-L39

a prezentowany jest w taki sposób

1. Małżonkowie podlegający obowiązkowi podatkowemu na mocy niniejszej ustawy, mogą na zgodny wniosek wspólnie rozliczyć osiągnięte dochody.
2. Dochody małoletnich dzieci własnych i przysposobionych podlegają odrębnemu opodatkowaniu.
2. Zasady i sposób opodatkowania, o którym mowa w ust. 1, ma zastosowanie również do osoby samotnie wychowującej dzieci:
1) małoletnie;

@piotr-calus
Copy link

W przypadku odnoszenia się do tekstu w PDF warto wkleić komentowany tekst, dla wygody czytających.

Cytowanie tekstu

Sam tekst można wkleić jako komentarz poprzedzając każdą linię znakiem >
Można to również zrobić wybierając w oknie edycji przycisk Add a quote lub korzystając ze skrótu <Ctrl-Shift-.>
W oknie edycji (Write) może wyglądać to następująco:

> ### Art. 5. [wspólne rozliczenie]
> 
> 1. Małżonkowie podlegający obowiązkowi podatkowemu na mocy niniejszej ustawy, mogą na zgodny wniosek wspólnie rozliczyć osiągnięte dochody.
> 2. Dochody małoletnich dzieci własnych i przysposobionych podlegają odrębnemu opodatkowaniu.

Natomiast po dodaniu komentarz będzie wyglądał następująco. Ostateczny wygląda można sprawdzić w zakładce podglądu (Preview).

Art. 5. [wspólne rozliczenie]

  1. Małżonkowie podlegający obowiązkowi podatkowemu na mocy niniejszej ustawy, mogą na zgodny wniosek wspólnie rozliczyć osiągnięte dochody.
  2. Dochody małoletnich dzieci własnych i przysposobionych podlegają odrębnemu opodatkowaniu.

Alternatywna możliwość formatowania to wklejenie tekstu jako kod umieszaczając przed i za cytowanym tekstem linię zawierającą trzy znaki ` (zazwyczaj pod klawiszem Esc) lub tyldy ~ (zazwyczaj ten sam klawisz w kombinacji z SHIFT)
Można to również zrobić wybierając w oknie edycji przycisk Add code
W oknie edycji komentarz może wyglądać tak:

```Markdown
### Art. 5. [wspólne rozliczenie]
 
1. Małżonkowie podlegający obowiązkowi podatkowemu na mocy niniejszej ustawy, mogą na zgodny wniosek wspólnie rozliczyć osiągnięte dochody.
2. Dochody małoletnich dzieci własnych i przysposobionych podlegają odrębnemu opodatkowaniu.
```

Po dodaniu zapisaniu

### Art. 5. [wspólne rozliczenie]

1. Małżonkowie podlegający obowiązkowi podatkowemu na mocy niniejszej ustawy, mogą na zgodny wniosek wspólnie rozliczyć osiągnięte dochody.
2. Dochody małoletnich dzieci własnych i przysposobionych podlegają odrębnemu opodatkowaniu.

@MacDada MacDada added the techniczne Technikalia, a nie merytoryka label May 18, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
techniczne Technikalia, a nie merytoryka
Projects
None yet
Development

No branches or pull requests

3 participants