Skip to content

Formátování, vysvětlivky#70

Open
stanekondrej wants to merge 6 commits into
bakalari-api:masterfrom
stanekondrej:master
Open

Formátování, vysvětlivky#70
stanekondrej wants to merge 6 commits into
bakalari-api:masterfrom
stanekondrej:master

Conversation

@stanekondrej

Copy link
Copy Markdown

PR k #68.

@stanekondrej

Copy link
Copy Markdown
Author

Já vím, je to obrovský diff, ale většina z toho jsou jen změny formátování. Prosím, projděte si ty moje změny a kdyžtak napište, co by se mělo změnit.

@stanekondrej
stanekondrej marked this pull request as ready for review June 28, 2026 15:06
@Lastaapps

Lastaapps commented Jun 28, 2026

Copy link
Copy Markdown
Contributor

Ahoj, jsou nějaké silné důvody k změně formátování v takovémhle rozsahu (ještě jsem nekoukal na samotný obsah, až večer kdyžtak)? Jestli ano, tak i tak by to za mě měl být separátní PR bez změn obsahu a s aspoň drobnou diskuzí, ať se nemíchají různé věci dohromady, kor kdyč se squshuje. Případně shrneš, prosím, co a proč jsi přeformátoval?

@Lastaapps

Copy link
Copy Markdown
Contributor

Aha, pardon, mně se do tohodle připletly emaily z #69

@stanekondrej

Copy link
Copy Markdown
Author

Prohnal jsem všechny dokumenty skrz Prettier, ale jo, asi by bylo lepší to udělat separátně. Takže mám vytáhnout to formátování do odděleného PR? Editor mi to udělal automaticky při uložení a nějak mi to nedošlo.

@Lastaapps Lastaapps left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Super, díky za to, vypadá to o dost líp. Jsem rád, žes to jenom nevzal formáterem, ale fakt jsi na to koukal a části přepsal.

Nicméně aby se tohle nové formátování zachovalo, by bylo strašně fajn udělat alespoň jednoduchý CONTRIBUTING.md s popisem, čím a jak se má formátovat, a pak .editorconfig (nebo co je teď standard) s počtem mezer na tab a max délkou řádku (+ další eventuelně). Kdyby sis chtěl víc hrát, můžeš potenciálně přidat pipelinu, co bude formátování kontrolovat a vynucovat.

Comment thread moduly/attachment.md
`name="=?utf-8?B?<STRING>?="`. Daný string dekódujete na bajty pomocí base64, a ty pak dekódujete na text pomocí utf-8
Pokud obsahuje název pouze ASCII znaky, parametr `name` vypadá takto:
`name=<filename>`. V opačném případě vypadá takto:
`name="=?utf-8?B?<STRING>?="`. Daný string dekódujete na bajty pomocí base64, a

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Když už tu jsou i něaké drobné změny, tušíme, jaká verze Base64 se tady použije (padding/URL/...)

Comment thread moduly/marks_measures.md
Comment thread moduly/web.md
```


<!-- TODO: tohle mi přijde redundantní. Možná odebrat?

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Mně osobně to pro konzistenci neuráží

Comment thread priklady/cURL.md

Vyšle request o login.

Url na začátku je vysvětleno v [README](../README.md).

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Kdybys chtěl být hodně pedantic, tak ještě můžeš sedem nahradit url a Url za URL

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ok, pak udělám

Comment thread login.md
"typ": "JWT",
"x5t": "XXXXXXXXXXXXXXXXXXXXXXXXXXX"
"typ": "oi_reft+jwt",
}

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Asi souhlasím s odstraněním. Pokud by to tam zůstalo, tak max jako fun fact pro čtenáře, aby si třeba vyhledal digitální podpisy.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

👍

@Lastaapps

Copy link
Copy Markdown
Contributor

A chápu teda správně, že bys chtěl nejdřív mergnout tohle a pak až #68?

@stanekondrej

Copy link
Copy Markdown
Author

Jo, kdyby se to rozdělilo tak nejdřív mergenout formátování jako takové a pak ty obsahové změny.

@stanekondrej

Copy link
Copy Markdown
Author

Nicméně aby se tohle nové formátování zachovalo, by bylo strašně fajn udělat alespoň jednoduchý CONTRIBUTING.md s popisem, čím a jak se má formátovat, a pak .editorconfig (nebo co je teď standard) s počtem mezer na tab a max délkou řádku (+ další eventuelně). Kdyby sis chtěl víc hrát, můžeš potenciálně přidat pipelinu, co bude formátování kontrolovat a vynucovat.

Ten pipeline mě taky napadl, asi by to nebylo od věci. Tak tyhle věci dám pak do dalšího PR.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants