Poznámky k verzi – únor 2018

Autorem tohoto příspěvku je Dan Fernandez, Senior Director v divizi Cloud a Enterprise.

Únor je za námi a je čas na další vydání poznámek k verzi webu docs.microsoft.com.

Nové vydané verze dokumentace

Právě jsme vydali další obsah, který vám pomůže se seznámit a naučit pracovat s dalšími našimi produkty!

Nadále pracujeme na migraci obsahu z MSDN na web docs.microsoft.com – zajistíme nejen správný přesun obsahu, ale i to, že odkazy automaticky povedou na nový obsah na webu docs.microsoft.com – pokud najdete nějaké nefunkční odkazy, dejte nám o nich vědět.

Nové nástroje funkcí &

Mnoho z funkcí, které jsme za poslední měsíc vytvořili, pracují na pozadí – vylepšujeme stabilitu a odolnost našich služeb a k tomu vytváříme nové publikační kanály pro různý obsah. Kromě toho ale přibyly dvě velké věci, které si ukážeme níže.

Python API Browser

Jedním z klíčových bodů dokumentace k rozhraní API je její ucelenost a snadná dostupnost. Vidíme, že .NET API Browser a PowerShell Module Browser mají u komunity úspěch, proto jsme chtěli jak novým, tak zkušeným vývojářům usnadnit hledání rozhraní API pro Python, která dodává Microsoft.

Nedávno jsme oznámili vydání Python API Browseru – lepšího způsobu, jak hledat rozhraní API pro Python dodávaná Microsoftem. Ať už pracujete se sadou Azure Python SDK, nebo Cognitive Toolkit, relevantní rozhraní API najdete rychle na webu docs.microsoft.com/python/api.

Python API Browser in action

S rostoucím počtem rozhraní API pro Python, která doručujeme, budeme i nadále aktualizovat Python API Browser novými vydanými verzemi.

Zpětná vazba k webu na GitHubu

V naší dokumentaci se snažíme pokračovat v otevřeném a transparentním přístupu – rádi vidíme, když má komunita možnost zaslat podrobnou zpětnou vazbu o tom, jak se dá prostředí dokumentace vylepšit. V rámci této snahy jsme převedli systém komentářů tak, aby zcela spoléhal na problémy GitHubu. To jediné, co bylo mimo GitHub, je zpětná vazba k webu.

Dříve jsme hostovali všechnu zpětnou vazbu k webu docs.microsoft.com na UserVoice. Tehdy to bylo dobré řešení, ale naše hlubší odhodlání pracovat s dokumenty hostovanými na GitHubu nás vedlo k tomu, že uživatelům chceme usnadnit zasílání zpětné vazby tam, kde už k našemu obsahu probíhá diskuze. Další rozhodnutí tedy bylo snadné – přesunout veškerou zpětnou vazbu k webu na GitHub.

Add new issues on GitHub

Každý den třídíme problémy, takže jakmile odešlete nějaký nápad, pravděpodobně se vám zanedlouho ozveme – popisky vám navíc pomůžou zjistit přesný stav žádosti. A nejen to. Díky funkcím uživatelského rozhraní problémů GitHubu se teď můžete podívat, který programový manažer bude vaši žádost řešit:

GitHub issue assigned to a docs PM

Při převodu jsme si dali pozor, abychom nezapomněli na žádný otevřený problém v UserVoice a všechny je migrovali do GitHubu, takže pokud jste už dříve poslali nějaký nápad, nikam se neztratí!

Poznámky pod čarou

Na tento rok toho plánujeme více a těšíme se na to, až vám budeme moct tyto novinky ukázat!

Mezitím sledujte nejnovější zprávy na našem blogu a na twitterovém účtu. Pokud máte nějaké návrhy nebo nápady na funkce, nezapomeňte vytvořit nový problém na GitHubu.

Sníte o tom, že zlepšíte svět pro vývojáře? Připojte se k našemu týmu!