docs: przybysze z Marketplace dostaja to, po co przyszli, nad zagieciem - #258
Merged
Merged
Conversation
Checked the published listing rather than assuming it was fine. Title and description are right, and GitHub generates the `uses:` snippet by itself. What it shows as the body is this repository's README, which opens with "Everything you need for the Microsoft 365 SMTP AUTH shutdown" - a mail relay pitch. So a developer browsing Marketplace for a CI action lands on a product page for something else, and has to scroll past a compatibility list, twenty-one code examples and a star history chart before finding out what the action does. A short block near the top now answers that in place: the snippet, what it checks, the certificate window that is the actual reason to add it to a pipeline, and a link to the full inputs further down. It is addressed to people who arrived from the Marketplace so it does not read as noise to somebody who came here for the relay. One thing this does not fix and cannot from here: the listing is in no Marketplace category at all, so nobody browsing by category can reach it. That is set on the listing itself rather than in action.yml.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Sprawdzone na opublikowanej wystawce, nie założone.
uses:Marketplace pokazuje jako treść README tego repozytorium, które otwiera się zdaniem „Everything you need for the Microsoft 365 SMTP AUTH shutdown" — czyli pitchem przekaźnika pocztowego.
Programista przeglądający Marketplace w poszukiwaniu akcji CI ląduje na stronie produktowej czegoś innego i musi przewinąć listę kompatybilności, 21 przykładów kodu i wykres gwiazdek, zanim dowie się, co ta akcja robi.
Krótki blok u góry odpowiada na to na miejscu: fragment YAML, co sprawdza, okno wygaśnięcia certyfikatu — czyli właściwy powód wstawienia tego do pipeline'u — i link do pełnych wejść niżej. Zaadresowany do przybyszów z Marketplace, żeby nie czytał się jak szum dla kogoś, kto przyszedł po przekaźnik.
Czego to nie naprawia i nie może stąd
Wystawka nie jest w żadnej kategorii Marketplace, więc nikt przeglądający po kategoriach do niej nie dotrze. To ustawia się na samej wystawce, nie w
action.yml.