Documentation
The Azure team is always trying to improve the content resources that help you to learn and use Azure. Conceptual content, how-to topics, getting started lists, graphics, and video are just some of the ways that this is being accomplished.
We need your help to decide what content is most useful for you. We also need your advice on how to improve existing content.
If you have any feedback, please vote on an idea or create a new suggestion. Thank you!
-
Secure data in the cloud: encryption and authorization
How to encrypt data safely and set proper authorization for permitted users/owners.
159 votesThank you for this suggestion. I need to do more research to understand the content we have in this area.
-
Environment and Subscription management with complex or distributed development teams.
Shows how to manage hosted service resources in a complex team environment.
131 votesIt seems like there could be a need for guidance in this area. I’ll investigate what we currently have out there and whether this is a common area of confusion for customers. I did find a good resource in a third-party blog post, http://blog.kloud.com.au/2013/07/30/good-practices-for-managing-windows-azure-subscriptions/. I’ll keep this thread updated as I research this.
-
Encryption at rest documentation
Can support provide a better documentation on Encryption-at-Rest? This is our concern. The only document I see if dated back to July 2012. Is there any current documentation?
128 votesI’ll try to find the content owners for this. It would help if you could provide a URL to the documentation that you see from 2012. Can you add this to the comments? Thanks!
-
Dynamic provisioning (instances, storage, bandwidth etc.) using Windows Azure APIs.
Shows how to use the Windows Azure APIs to dynamically provision resources based on application needs.
105 votesI apologize for the delay on this Windows Azure feedback item. For Dynamic Provisioning, custom solutions can be created using the Service Management API (http://msdn.microsoft.com/en-us/library/windowsazure/ee460799.aspx). However, based on the comments, I believe it is more than just having the commands. At this time, we have the AutoScale (Preview) http://weblogs.asp.net/scottgu/archive/2013/06/27/windows-azure-general-availability-release-of-web-sites-mobile-services-new-autoscale-alerts-support-no-credit-card-needed-for-msdn-subscribers.aspx as well as the Autoscaling application block http://msdn.microsoft.com/en-us/library/hh680892(v=PandP.50).aspx.
So for this documentation suggestion, I would be interested in more comments on whether these solutions meet the needs of the original request. Or is there still a need to provide guidance on how you would dynamically provision resources in a custom coding solution? Thank you.
-
Windows Azure Storage Table version management
Shows how to manages changes to data stored in Windows Azure Storage tables.
54 votesWe are looking into whether there is guidance on this in the current documentation.
-
Best practices for sharding SQL Server databases into multiple SQL Azure dbs
The recommended solution for breaking up large SQL Server databases to fit into SQL Azure is sharding. I'd love to see examples, samples, and best practices for accomplishing this.
33 votesI apologize for the delayed response on this Windows Azure feedback item. Our Customer Advisory Team (CAT) has recently released a project called Cloud Services Fundamentals. This project contains some best practices for sharding. See this article: http://blogs.msdn.com/b/windowsazure/archive/2013/09/05/dal-sharding-of-rdbms.aspx. And see the project: http://code.msdn.microsoft.com/Cloud-Service-Fundamentals-4ca72649. In addition, there is a great paper on designing large scale Windows Azure applications here: http://msdn.microsoft.com/en-us/library/windowsazure/jj717232.aspx. Finally, there is an older post on sharding here: http://blogs.msdn.com/b/sqlazure/archive/2010/06/24/10029719.aspx.
However, even with all of these resources, I’m not sure we have an easy-to-find paper with best practices in this area. I’m going to do some research to see if this is something we might do. Thanks for the idea. If there are other comments anyone would like to add to this request, please do so.
-
XML Schema for request/response messages of azure REST API
Azure REST API currently does not have any published XML Schema for request and response messages. Such schema could be very helpful for developer to marshalling and validating the XML messages. In general it is also a basic need for a webservices consumer to know about the messages schema.
19 votesWe have documentation for our API here: http://msdn.microsoft.com/en-us/library/windowsazure/ee460799.aspx. Every API call should have a documented request URI, request body, and response body (where applicable).
Does this meet your development needs? Or do you need this information in another format for message marshalling/validation?
-
Communicate with trial users before deleting VMs
All marketing and informational materials concerning trial accounts from Microsoft Azure do not make any indication of a Deletion of VMs when a spending cap is reached. All information indicates that the VMs will be Disabled - but not Deleted. As an example: http://www.windowsazure.com/en-us/pricing/spending-limits/
I was directed by Microsoft to create a trial account as the entry point into Windows Azure, and that I could take up to 3 months to upgrade to a full subscription. As a new user, I was unaware of how to access the subscription cost incurred panel (I still have difficulty navigating it - and…
18 votesHello. I apologize for your lost work, and thanks to David Mills for pointing out that your VMs are not redeployable (http://social.msdn.microsoft.com/Forums/en-US/WAVirtualMachinesforWindows/thread/a00b2e34-be7b-4f05-af75-f239613c5599). However, this should have been more clear to you, and I’m looking into whether we can improve communication and/or notifications about this issue. Thank you.
-
Create guidance packages for common supported scenario's. So it's very easy to get started.
Create guidance packages for common supported scenario's. It should be very easy to get started. It should be not more complicated than :
1. Set your connection string to Azure,
2. point to an XSD and presto there is your webservice.
3. Want to store received requests in a table, just add that checkbox.
4. Want processing on that table, just cjeck that checkbox.....I could go on for a while. Having guidance will lower complexity, and give everyone a easy trouble free start. That is always a good thing.
12 votesI apologize for the delay in responding to your Windows Azure feedback item. At this time, we don’t have a plan to create guidance packages like this with variable options. However, we do want to continue to provide good documentation and samples for common scenarios. If there are holes in specific supported scenarios, please let us know by adding items to this feedback forum.
With this said, have you seen this model used successfully in the past? If you would like to provide more details, it would help us to evaluate whether something like this would be possible in the future. I’m going to leave this item under review to give you a chance to provide some more details on how this might work. I can’t promise that we can do it, but I would like to understand what form this would take in order to better consider it. Thank…
-
Using custom synchronization providers against Windows Azure Storage
Shows how to provide custom synchronization for Windows Azure Storage.
11 votesI apologize for the delayed response to this feedback item. I assume that this suggestion is to provide documentation around the Microsoft Sync Framework and its integration with Windows Azure. Specifically with custom providers (http://msdn.microsoft.com/en-us/library/bb902847.aspx). For people following this thread or voting on it, please add comments to indicate the type of guidance needed. Also, add comments if the Sync Framework is not in mind as much as just programmatic guidance for synchronization techniques. Once there is more information on the thread, we can investigate the possibility of creating new content around this need.
-
review articles in Documentation section occasionally & *have a date of publication or modification on it* to indicate info is up-to-date
The HOW TO articles in the Windows Azure documentation (http://www.windowsazure.com/en-us/documentation/) have been very helpful. However, there are times when the info there gets stale due to changes in the SDK. I understand it is a challenge to update these articles every time there is a dependent change but it is frustrating for a reader to walk through a sample and while trying it out, find that some piece used to work earlier but won't work now due to a breaking change. If there is a date of publication or modification, readers can at least guess that it could…
9 votesWe are currently planning to implement this idea, both in reviewing more frequently as well as consistently adding the publish date. We completely agree that with the fast pace of Windows Azure releases, that this is more necessary. Thanks for the suggestion. I’ll update this idea when I can confirm that this process is fully in place.
-
broken UI
All most all pages relating to AZURE is broken. the width of the page has a lot of padding, and doesn't fit.
MSDN docs seems to have changed; looks like the team behind it is having fun changing/rolling-out new CSS every other 3months or so. I hate all of them. MSDN doc is a dev-doc, and should have minimal js and CSS. Please remove all these stupid CSS/JS and return it to a simple fast-loading page.
PROBLEM: http://msdn.microsoft.com/library/windowsazure/dn339013.aspx (for example) is broken. because the page width is restricted to a small width and padding with absolutely useless padding. Now, a…
9 votesI apologize for the problem you’ve seen on the MSDN documentation with the fixed-width layout. We have been attempting to correct any tables or images that are affected by this layout, so I’ll try to get the page your referenced corrected.
However, I know that this is just one example. I want to point out that the MSDN library for Windows Azure is “skinned”, which adds the style sheet. If you ever see any problems, you can take “windowsazure” off of the URL and you’ll go to the regular MSDN view. Here is the same URL you sent but with windowsauzre removed:
http://msdn.microsoft.com/library/dn339013.aspx
Please let me know if this helps. I realize it does not correct everything that you dislike about the Windows Azure style of MSDN, and I’ll provide that feedback to the appropriate people as well. Thank you.
-
Clarify the information on Monthly Azure credit for Visual Studio Enterprise (BizSpark) subscribers
I have found contradicting information on this page
https://azure.microsoft.com/en-gb/offers/ms-azr-0064p/
I am a BizSpark member and I am trying to establish whether the £95 of Azure credit per subscription for 5 developers in my team allows us to use those credits for Production.
The last paragraph of the Get Started section says:- "As a special BizSpark benefit, you can run both dev/test and production workloads with this offer."
But the Use Rights section near the bottom of the same page says:- "This benefit is for development and testing only. We reserve the right to suspend any instance (VM or cloud service)…
7 votes -
Some Korean (ko-kr) Azure document pages are wrongly displayed
Hello,
First of all, thank you very much for opening docs.microsoft.com with lots of Azure related articles! Even Korean translations are so cooool!
Korean Azure contents are translated and shared into https://github.com/Azure/azure-content-kokr/ page (original: https://github.com/Azure/azure-content )
By the way, would you see those two pages?
[1] https://docs.microsoft.com/en-us/active-directory/active-directory-devquickstarts-dotnet
[2] https://docs.microsoft.com/ko-kr/active-directory/active-directory-devquickstarts-dotnet[1] is the original article, and [2] is the same article but translated into Korean. However, [2] is wrongly displayed.
Actually I don't know why it happened. On github repository, it seemed good. Is there some problems on parsing github content for translated pages? Hope that Korean translated pages will be…
7 votes -
Add more metadata to every page of documentation
At present, documentation (whch is in the main pretty good and getting better) has little metadata. I see an artilce and don't know when it was written, or when it was updated.
What I would like to see on every page of documentration:
1. Date this copy was written
2. Regions to which this documentation applies (if not everywhere)
3. Last time the documentation was reviewed and found to be accurate.I'd also like to see a change log - what changed and when. This needn't be massive - I just want to note that's new and what's not new!
…
6 votes -
Associate Windows Azure with MS Training Kits
I work as a SharePoint Consultant and I'm studying a lot about SharePoint 2013.
As a consultant I'm frequently at customers and just have my laptop for study purposes.
So my main problem is - I (and I think the most of IT Pros) doesn't have own enough hardware to study everything we need. Please take a look on some SharePoint 2013 hardware requirements:
http://technet.microsoft.com/en-us/library/cc262485.aspx#hwLocServers
Actually I'm studying SharePoint High Availability, so it's impractical to do any related lab with an Intel i5 + 8GB RAM (to say the truth, most of all others labs are hard to do with…
5 votesThis is a creative self-study solution, and you’re right that Windows Azure is an ideal environment for this type of short-term hardware acquisition and use. I will look into this and update this thread when I get more information.
-
Update documentation more frequently
Hi,
the documentation on MSDN should be updated more frequently to represent the current state of union more accurate.
4 votes -
Give more information about how Microsoft Azure expects programmers to get X.509 V3 certificate....some articles talk about building one!!!
I am a computer programmer that is about to write an application for Azure. I read that I need a X.509 V3 certificate. But I haven't seen any instructions telling me how Windows Azure expects new programmers should get an X.509 V3 certicate. I searched for forums but found nothing that addresses that directly. What is acceptable for Windows Azure? Can I or should I bet a certificate from a certificate seller like https://www.verisign.com ?
More clear instructions about how to get acquire a X.509 certificate is needed badly.
4 votesI apologize for the delayed response. Could you let me know what you are needing the certificate for? I am guessing it might be for SSL. If so, could you look at http://www.windowsazure.com/en-us/documentation/articles/web-sites-configure-ssl-certificate/. If you struggling with how to use certificates for other uses in Azure, please add a comment, and I’ll see if we have existing documentation or whether this is something we should improve. I apologize that you weren’t able to easily find what you need. Certificates and SSL is a complex area.
-
Mobile Services documentation should be more than simple example code.
The mobile services documentation is a bunch of implementation examples with detailed walkthroughs of how to add the service to your Azure account and simplistic example code with minimal explanation.
The mobile services documentation doesn't explain what Mobile Services is, what it can and (most importantly) can't do, how to choose between Mobile Services, Websites, and Cloud Services, etc.
3 votes -
Azure should publish document on how to automate the workflows.
Azure documentation should include the code snippets to automation. The certification prep has more details then azure website
3 votes
- Don't see your idea?
