Opmerkingen bij de release - februari 2018

Dit bericht is geschreven door Dan Fernandez, Senior Director in de Cloud + Enterprise-divisie.

Februari is voorbij en het tijd is voor een nieuwe versie van de opmerkingen bij de release van docs.microsoft.com.

Nieuwe documentatieversies

We hebben zojuist meer inhoud uitgebracht waarmee u meer van onze producten leert kennen.

We blijven inhoud migreren van MSDN naar docs.microsoft.com. We garanderen niet alleen dat de inhoud op de juiste manier wordt verplaatst, maar ook dat koppelingen automatisch naar de nieuwe inhoud op docs.microsoft.com verwijzen. Vindt u verbroken koppelingen, meld deze dan.

Nieuwe functies en hulpprogramma's

Veel van de functies die we de afgelopen maanden hebben gebouwd, werken achter de schermen. Zo verbeteren we de stabiliteit en flexibiliteit van onze services en bouwen tegelijk nieuwe publicatiepijplijnen voor verschillende inhoudselementen. Dat gezegd hebbende: we hebben wel twee grote nieuwe dingen toegevoegd, die u verderop kunt bekijken.

Python-API-browser

Een van de belangrijkste punten wat API-documentatie betreft, is ervoor zorgen dat deze uitgebreid en eenvoudig te vinden is. We zagen al eerder dat de .NET API-browser en de PowerShell Module Browser erg populair waren in de community. We wilden de door Microsoft geleverde Python-API's daarom voor zowel nieuwe als doorgewinterde ontwikkelaars gemakkelijk vindbaar maken.

Onlangs hebben we de release aangekondigd van de Python-API-browser, een betere manier om te zoeken naar door Microsoft geleverde/aangeboden Python-API's. Of u nu met Azure Python SDK of Cognitive Toolkit werkt, u kunt de relevante API's snel vinden door naar docs.microsoft.com/python/api te gaan.

Python-API-browser in actie

Omdat we steeds meer Python-API's verzenden, blijven we de Python-API-browser bijwerken met nieuwe releases.

Sitefeedback op GitHub

We blijven streven naar openheid en transparantie in onze documentatie en horen graag dat onze community niet schroomt om gedetailleerde feedback te geven over verbeteringen van hun ervaring met onze documentatie. Als onderdeel van deze inspanningen hebben we ons opmerkingensysteem omgegooid; we vertrouwen nu volledig op GitHub Issues. Sitefeedback was het enige onderdeel dat nog niet via GitHub verliep.

Voorheen werd al onze sitefeedback voor docs.microsoft.com op UserVoice gehost. Dat was op dat moment een prima oplossing omdat we ons meer richtten op in GitHub gehoste documenten, maar we wilden de irritatie van gebruikers wegnemen door hen feedback te laten geven op dezelfde locatie waar ook de gesprekken plaatsvinden. De volgende beslissing was dus eenvoudig: al onze sitefeedback naar GitHub verplaatsen!

Toevoegen van nieuwe problemen op GitHub

We sorteren dagelijks allerlei problemen, dus wanneer u uw idee inzendt is de kans groot dat u al snel iets van ons hoort. En met behulp van labels weet u precies welke status de aanvraag heeft. Bovendien kunt u, gezien de kracht van de GitHub Issues-gebruikersinterface, nu zien welke programmabeheerder verantwoordelijk is voor de follow-up:

GitHub Issue toegewezen aan een PM voor de documenten

Tijdens de overgang hebben we continu gecontroleerd of alle openstaande problemen van UserVoice naar GitHub werden gemigreerd. Dus als u eerder ideeën hebt ingestuurd, dan zijn deze nog steeds aanwezig.

Voetnoten

Er zijn meer dingen gepland voor het komende jaar en wij kunnen niet wachten om ze u te laten zien.

Vergeet ondertussen niet onze blog en ons Twitter-account te volgen voor de nieuwste updates. Als u suggesties of ideeën voor functies hebt, vergeet dan niet om een nieuw probleem te openen op GitHub.

Is het uw droom om de wereld te verbeteren voor ontwikkelaars? Kom bij ons team!