Note sulla versione - Gennaio 2019

Questo post è stato scritto da Den Delimarsky, Program Manager nella divisione Cloud and AI.

Benvenuti in un'altra installazione di docs.microsoft.com note sulla versione, la prima nel 2019! Siamo lieti di continuare a migliorare le nostre esperienze con nuovi strumenti, miglioramenti ai contenuti e riconoscere più collaboratori della community.

Collaboratori della community

La nostra community è la chiave per molti miglioramenti alla documentazione che abbiamo ospitato: è probabile che, ogni volta che si legge un articolo su docs.microsoft.com, ha avuto un contributo da qualcuno proprio come dedicato all'accuratezza complessiva e alla qualità della documentazione così come siamo. Centinaia di persone dedicano ore per migliorare la documentazione per tutti! Vorremmo riconoscerne alcuni nel post di blog di questo mese.

Se sei interessato a contribuire al nostro contenuto, inizia con la nostra guida per i collaboratori!

Valeriy Novytskyy

Noto anche come 01binary su GitHub, Valeriy ha fatto un ottimo lavoro rendendo la documentazione ASP.NET Core migliore migliorando gli esempi di codice di sicurezza. Gli esempi di codice sono quelli che gli sviluppatori iniziano con nei progetti e nelle esplorazioni e sono lieti di vederli più completi e affidabili.

Dave Brock

Dave è stato un collaboratore attivo alla documentazione ASP.NET Core. Ha inviato più di 10 diverse richieste pull per rendere la documentazione più accurata e intuitiva nell'arco di pochi mesi! Può essere trovato su Twitter come @daveabrock.

Lynn Park

Lynn è un nuovo collaboratore alla documentazione, con la prima richiesta pull appena unita nella documentazione di Entity Framework. Lei è un lettore frequente di docs.microsoft.com che ha deciso di restituire, e coraggiosamente ha fatto il suo primo contributo open source. Puoi trovarla su Twitter.

Versioni del contenuto

Man mano che cresce l'offerta di prodotti, microsoft si propone di garantire sempre di fornire la documentazione più aggiornata e pertinente per gli utenti. Questo mese è stata ampliata la raccolta contenuto una docs.microsoft.com con l'aggiunta della nuova documentazione dell'API Java per Servizi multimediali di Azure, documentazionedell'API .NET per Windows Server 2019, documentazione dell'API REST per Data Lake Storage Gen2 e un aggiornamento a Documentazione su Python di QnA Maker di Servizi cognitivi.

Funzionalità

Estensione markdownlint per supportare Markdown personalizzato docs

Uno dei componenti più diffusi di Docs Authoring Pack per VS Code è markdownlint dallo sviluppatore Microsoft David Anson, che consente ai collaboratori di assicurarsi che il contenuto segua le procedure consigliate di Markdown. Markdownlint è ora estendibile e il team di progettazione di Docs ha iniziato ad aggiungere regole personalizzate per supportare estensioni Markdown specifiche di Docs. Queste regole vengono installate come parte di Docs Authoring Pack, quindi se si usa il pacchetto non è necessario eseguire alcuna operazione speciale per avviare l'linting Docs Markdown.

Presto sarà disponibile un'ulteriore linting personalizzata, tra cui il controllo dei collegamenti sicuri (https://) e l'linting della sintassi per gli avvisi di Docs, ad esempio [!NOTE], rendendo ancora più semplice contribuire a nuovi contenuti per docs.microsoft.com.

Note a piè di pagina

Per quest'anno sono previsti altri aspetti in molte aree dello spazio di documentazione. Per rimanere aggiornati, assicurarsi di seguire il blog e l'account Twitter. Se si hanno suggerimenti o idee sulle funzionalità, non dimenticare di aprire un nuovo problema in GitHub.