{"id":2495,"date":"2018-07-17T08:52:34","date_gmt":"2018-07-17T16:52:34","guid":{"rendered":"http:\/\/blogs.msdn.microsoft.com\/pythonengineering\/?p=2495"},"modified":"2019-11-18T22:00:56","modified_gmt":"2019-11-19T06:00:56","slug":"new-web-app-tutorials-in-the-vs-and-vs-code-python-docs-and-docs-feedback","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/python\/new-web-app-tutorials-in-the-vs-and-vs-code-python-docs-and-docs-feedback\/","title":{"rendered":"New web app tutorials in the VS and VS Code Python docs, and docs feedback"},"content":{"rendered":"<p><em>This post was written by Kraig Brockschmidt<\/em><\/p>\n<p>Recognizing the popularity of the Django and Flask web app frameworks, we recently added several tutorials in the Python documentation that guide you through working with these frameworks in Microsoft\u2019s Python-capable IDEs: the lightweight Visual Studio Code available on all operating systems, and the full Visual Studio for Windows. If you haven\u2019t seen the tutorials yet, this blog post gives you a brief introduction. We also wanted to take the opportunity to highlight how you can contribute to docs, and the ways you can give feedback\u2014both of which we very much welcome!<\/p>\n<h2>Flask in Visual Studio Code<\/h2>\n<p>First is <a href=\"https:\/\/code.visualstudio.com\/docs\/python\/tutorial-flask\">Using Flask in Visual Studio Code<\/a>, an already popular walkthrough that starts with creating an environment for Flask and getting a very simple Hello World app up and running. From there it introduces Python debugging and debugger configurations for Flask, using page templates, serving static files, and using template inheritance. The end result is a multi-page app as shown below, which can serve as a starting point for projects of your own. The completed code for the tutorial is available on <a href=\"https:\/\/github.com\/Microsoft\/python-sample-vscode-flask-tutorial\">GitHub<\/a>.<\/p>\n<p><a href=\"https:\/\/devblogs.microsoft.com\/wp-content\/uploads\/sites\/12\/2019\/02\/1_FlaskTutorial.png\"><img decoding=\"async\" class=\"alignnone size-full wp-image-2545\" src=\"https:\/\/devblogs.microsoft.com\/python\/wp-content\/uploads\/sites\/12\/2018\/07\/1_FlaskTutorial-2.png\" alt=\"\" width=\"390\" height=\"152\" \/><\/a><\/p>\n<h2>Django and Flask in Visual Studio<\/h2>\n<p>For Visual Studio, we\u2019ve added two series of tutorials for Django and Flask.<\/p>\n<p><a href=\"https:\/\/docs.microsoft.com\/en-us\/visualstudio\/python\/learn-django-in-visual-studio-step-01-project-and-solution\">Learn Django in Visual Studio<\/a> is a series of six articles in which you learn how to do the following:<\/p>\n<ul>\n<li>Step 1: Create a basic Django project in a Git repository using the &#8220;Blank Django Web Project&#8221; template<\/li>\n<li>Step 2: Create a Django app with one page and render that page using a template<\/li>\n<li>Step 3: Serve static files, add pages, and use template inheritance<\/li>\n<li>Step 4: Use the Django Web Project template to create an app with multiple pages and responsive design<\/li>\n<li>Step 5: Authenticate users<\/li>\n<li>Step 6: Use the Polls Django Web Project template to create an app that uses models, database migrations, and customizations to the administrative interface<\/li>\n<\/ul>\n<p>As you can see, in this tutorial you learn about Django in the context of Visual Studio project templates. The tutorial explains everything that\u2019s happening in the templates, so you can easily adapt the template-generated apps to suit your own needs. The code for the tutorial can of course be found on <a href=\"https:\/\/github.com\/Microsoft\/python-sample-vs-learning-django\">GitHub<\/a>.<\/p>\n<p><a href=\"https:\/\/docs.microsoft.com\/en-us\/visualstudio\/python\/learn-flask-visual-studio-step-01-project-solution\">Learn Flask in Visual Studio<\/a>, similarly, walks you through the different Flask project templates (<a href=\"https:\/\/github.com\/Microsoft\/python-sample-vs-learning-flask\">code on GitHub<\/a>):<\/p>\n<ul>\n<li>Step 1: Create a basic Flask project in a Git repository using the &#8220;Blank Flask Web Project&#8221; template<\/li>\n<li>Step 2: Create a Flask app with one page and render that page using a template<\/li>\n<li>Step 3: Serve static files, add pages, and use template inheritance<\/li>\n<li>Step 4: Use the Flask Web Project template to create an app with multiple pages and responsive design<\/li>\n<li>Step 5: Use the Polls Flask Web Project template to create a polling app that uses a variety of storage options (Azure storage, MongoDB, or memory).<\/li>\n<\/ul>\n<h2>Other Highlights<\/h2>\n<p>We\u2019ve also recently added a <a href=\"https:\/\/docs.microsoft.com\/en-us\/visualstudio\/python\/python-item-templates\">reference for Python-related item templates in Visual Studio<\/a>. And if you\u2019re interested in writing C++ modules that you can use from your Python programs, check out <a href=\"https:\/\/docs.microsoft.com\/en-us\/visualstudio\/python\/working-with-c-cpp-python-in-visual-studio\">Creating a C++ extension for Python<\/a>.<\/p>\n<h2>Contribute to the documentation!<\/h2>\n<p>Did you know that all the documentation for Visual Studio and Visual Studio Code is open source?<\/p>\n<ul>\n<li>Visual Studio: <a href=\"https:\/\/github.com\/MicrosoftDocs\/visualstudio-docs\">https:\/\/github.com\/MicrosoftDocs\/visualstudio-docs<\/a><\/li>\n<li>Visual Studio Code: <a href=\"https:\/\/github.com\/Microsoft\/vscode-docs\">https:\/\/github.com\/Microsoft\/vscode-docs<\/a><\/li>\n<\/ul>\n<p>We\u2019re delighted to receive contributions from the community in both docsets, and actively monitor pull requests. Truly, no contribution is too small. As the content developer who manages these docsets, I very much appreciate anyone who takes the time to fix a typo, correct an error, or otherwise make the docs better! Your contribution doesn\u2019t have to be perfect, either: we\u2019ll take the time to do the necessary editing and formatting.<\/p>\n<p>And did you know you can contribute by simply using the <strong>Edit<\/strong> command that appears on each article in the Visual Studio Code docs:<\/p>\n<p><a href=\"https:\/\/devblogs.microsoft.com\/wp-content\/uploads\/sites\/12\/2019\/02\/2_ContributingToDocs.png\"><img decoding=\"async\" class=\"alignnone size-full wp-image-2505\" src=\"https:\/\/devblogs.microsoft.com\/python\/wp-content\/uploads\/sites\/12\/2018\/07\/2_ContributingToDocs-2.png\" alt=\"\" width=\"768\" height=\"137\" \/><\/a><\/p>\n<p>and in the Visual Studio docs?<\/p>\n<p><a href=\"https:\/\/devblogs.microsoft.com\/wp-content\/uploads\/sites\/12\/2019\/02\/3_EditDjangoDocs.png\"><img decoding=\"async\" class=\"alignnone size-full wp-image-2515\" src=\"https:\/\/devblogs.microsoft.com\/python\/wp-content\/uploads\/sites\/12\/2018\/07\/3_EditDjangoDocs-2.png\" alt=\"\" width=\"874\" height=\"201\" \/><\/a><\/p>\n<p>Those links take you straight into the GitHub repository for that article, where you can make edits, see the history, and enjoy all the other GitHub goodness.<\/p>\n<h2>Give docs feedback: what would you like to see?<\/h2>\n<p>We also welcome any doc issues or requests you have for new content. In the Visual Studio Docs, the <strong>Feedback <\/strong>command that alongside <strong>Edit<\/strong> takes you to the bottom of the page where you can create GitHub issues without leaving the docs at all. The Feedback section also shows existing issues and provides a <strong>Product Feedback <\/strong>link through which you can file bugs and feature requests for the Python Tools themselves. You can also just create an issue at any time directly in the <a href=\"https:\/\/github.com\/MicrosoftDocs\/visualstudio-docs\/issues\/1086\">Visual Studio docs repo<\/a>.<\/p>\n<p><a href=\"https:\/\/devblogs.microsoft.com\/wp-content\/uploads\/sites\/12\/2019\/02\/4_GiveFeedback.png\"><img decoding=\"async\" class=\"alignnone size-full wp-image-2525\" src=\"https:\/\/devblogs.microsoft.com\/python\/wp-content\/uploads\/sites\/12\/2018\/07\/4_GiveFeedback-2.png\" alt=\"\" width=\"628\" height=\"371\" \/><\/a><\/p>\n<p>We\u2019re very responsive to issues and requests. For example, <a href=\"https:\/\/github.com\/MicrosoftDocs\/visualstudio-docs\/issues\/1086\">VS docs issue 1086<\/a>, shown above, identified a detail that was missing from the documentation for the Python Environments window, which we fixed within a day!<\/p>\n<p>For Visual Studio Code, we don\u2019t have integration with GitHub directly in the docs, so just <a href=\"https:\/\/github.com\/Microsoft\/vscode-docs\/issues\/1637\">file an issue directly in the repo<\/a>. For product feedback, use the Request and Report links on the right side of each docs page:<\/p>\n<p><a href=\"https:\/\/devblogs.microsoft.com\/wp-content\/uploads\/sites\/12\/2019\/02\/5_ReportIssues.png\"><img decoding=\"async\" class=\"alignnone size-full wp-image-2535\" src=\"https:\/\/devblogs.microsoft.com\/python\/wp-content\/uploads\/sites\/12\/2018\/07\/5_ReportIssues-2.png\" alt=\"\" width=\"157\" height=\"207\" \/><\/a><\/p>\n<p>To file a issues for the Python Extension for Visual Studio Code itself (not the docs), go to <a href=\"https:\/\/github.com\/Microsoft\/vscode-python\/issues\">https:\/\/github.com\/Microsoft\/vscode-python\/issues<\/a>.<\/p>\n<p>In closing, it\u2019s worth mentioning that although you can leave feedback through the \u201cIs this page helpful?\u201d controls in the docs, they are anonymous mechanisms that unfortunately don\u2019t provide us any way to respond. We vastly prefer that you use GitHub issues so we can ask for more details and let you know when the issue has been addressed.<\/p>\n<p>&nbsp;<\/p>\n<p>Kraig Brockschmidt\nContent Developer for Python in Visual Studio and Visual Studio Code<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Recognizing the popularity of the Django and Flask web app frameworks, we recently added several tutorials in the Python documentation that guide you through working with these frameworks in Microsoft\u2019s Python-capable IDEs: the lightweight Visual Studio Code available on all operating systems, and the full Visual Studio for Windows. We also wanted to take the opportunity to highlight how you can contribute to docs, and the ways you can give feedback\u2014both of which we very much welcome!<\/p>\n","protected":false},"author":883,"featured_media":2820,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[6],"tags":[],"class_list":["post-2495","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-visual-studio-code"],"acf":[],"blog_post_summary":"<p>Recognizing the popularity of the Django and Flask web app frameworks, we recently added several tutorials in the Python documentation that guide you through working with these frameworks in Microsoft\u2019s Python-capable IDEs: the lightweight Visual Studio Code available on all operating systems, and the full Visual Studio for Windows. We also wanted to take the opportunity to highlight how you can contribute to docs, and the ways you can give feedback\u2014both of which we very much welcome!<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/python\/wp-json\/wp\/v2\/posts\/2495","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/python\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/python\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/python\/wp-json\/wp\/v2\/users\/883"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/python\/wp-json\/wp\/v2\/comments?post=2495"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/python\/wp-json\/wp\/v2\/posts\/2495\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/python\/wp-json\/wp\/v2\/media\/2820"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/python\/wp-json\/wp\/v2\/media?parent=2495"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/python\/wp-json\/wp\/v2\/categories?post=2495"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/python\/wp-json\/wp\/v2\/tags?post=2495"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}