Explorar el Código

Add tutorial disclaimer for new extended tutorial (#11259)

Thibaud Colas hace 1 año
padre
commit
0ae74e1d5a

+ 5 - 1
docs/advanced_tutorial/add_search.md

@@ -1,5 +1,9 @@
 # Add search to your site
 
+```{warning}
+We’ve just released this new tutorial. Do you want to provide feedback? Please complete our [2023 tutorial feedback form](https://wagtail.org/gsod-2023-feedback/).
+```
+
 Using the Wagtail `start` command to start your project gives you a built-in search app. This built-in search app provides a simple search functionality for your site.
 
 However, you can customize your search template to suit your portfolio site. To customize your search template, go to your `search/templates/search.html` file and modify it as follows:
@@ -88,4 +92,4 @@ Now, you want to display your search across your site. One way to do this is to
 </header>
 ```
 
-Welldone! You now have a fully deployable portfolio site. The next section of this tutorial will walk you through how to deploy your site.
+Welldone! You now have a fully deployable portfolio site. The next section of this tutorial will walk you through how to deploy your site.

+ 6 - 1
docs/advanced_tutorial/create-footer_for_all_pages.md

@@ -1,4 +1,9 @@
 # Create a footer for all pages
+
+```{warning}
+We’ve just released this new tutorial. Do you want to provide feedback? Please complete our [2023 tutorial feedback form](https://wagtail.org/gsod-2023-feedback/).
+```
+
 The next step is to create a footer for all pages of your portfolio site. You can display social media links and other information in your footer.
 
 ## Add a base app
@@ -317,4 +322,4 @@ Add your `footer_text` template to your footer by modifying your `mysite/templat
 
 Now, restart your server and reload your [homepage](http://127.0.0.1:8000/). For more information on how to render your Wagtail snippets, read [Rendering snippets](../topics/snippets/rendering.md).
 
-Well done! 👏 You now have a footer across all pages of your portfolio site. In the next section of this tutorial, you'll learn how to set up a site menu for linking to your homepage and other pages as you add them.
+Well done! 👏 You now have a footer across all pages of your portfolio site. In the next section of this tutorial, you'll learn how to set up a site menu for linking to your homepage and other pages as you add them.

+ 4 - 0
docs/advanced_tutorial/create_contact_page.md

@@ -1,5 +1,9 @@
 # Create contact page
 
+```{warning}
+We’ve just released this new tutorial. Do you want to provide feedback? Please complete our [2023 tutorial feedback form](https://wagtail.org/gsod-2023-feedback/).
+```
+
 Having a contact page on your portfolio site will help you connect with potential clients, employers, or other professionals who are interested in your skills.
 
 In this section of the tutorial, you'll add a contact page to your portfolio site using Wagtail forms.

+ 5 - 1
docs/advanced_tutorial/create_portfolio_page.md

@@ -1,5 +1,9 @@
 # Create a portfolio page
 
+```{warning}
+We’ve just released this new tutorial. Do you want to provide feedback? Please complete our [2023 tutorial feedback form](https://wagtail.org/gsod-2023-feedback/).
+```
+
 A portfolio page is a web page that has your resume or Curriculum Vitae (CV). The page will give potential employers a chance to review your work experience.
 
 This tutorial shows you how to add a portfolio page to your portfolio site using the Wagtail StreamField. 
@@ -390,4 +394,4 @@ To add your resume to your portfolio site, follow these steps:
 
 3. Publish your `Portfolio Page`.
 
-Congratulations🎉! You now understand how to create complex flexible layouts with Wagtail StreamField. In the next tutorial, you'll learn how to add search functionality to your site.
+Congratulations🎉! You now understand how to create complex flexible layouts with Wagtail StreamField. In the next tutorial, you'll learn how to add search functionality to your site.

+ 6 - 0
docs/advanced_tutorial/customize_homepage.md

@@ -1,5 +1,11 @@
 # Customize your home page
 
+```{warning}
+We’ve just released this new tutorial. Do you want to provide feedback? Please complete our [2023 tutorial feedback form](https://wagtail.org/gsod-2023-feedback/).
+```
+
+Heads’up! Make sure you have completed [Your first Wagtail site](../getting_started/tutorial.md) before going through this extended tutorial.
+
 When building your portfolio website, the first step is to set up and personalize your homepage. The homepage is your chance to make an excellent first impression and convey the core message of your portfolio. So your homepage should include the following features:
 
 1. **Introduction:** A concise introduction captures visitors' attention.

+ 5 - 1
docs/advanced_tutorial/deployment.md

@@ -1,5 +1,9 @@
 # Deploy your site
 
+```{warning}
+We’ve just released this new tutorial. Do you want to provide feedback? Please complete our [2023 tutorial feedback form](https://wagtail.org/gsod-2023-feedback/).
+```
+
 So far, you've been accessing your site locally. Now, it's time to deploy it.
 
 Deployment makes your site publicly accessible by moving it to a production server. Upon deployment, your site becomes accessible worldwide.
@@ -476,4 +480,4 @@ If you encounter errors while trying to access your live site in your browser, c
 
 -   Read the Wagtail [topics](../topics/index) and [reference](../reference/index) documentation
 -   Learn how to implement [StreamField](../topics/streamfield) for freeform page content
--   Browse through the [advanced topics](../advanced_topics/index) section and read [third-party tutorials](../advanced_topics/third_party_tutorials)
+-   Browse through the [advanced topics](../advanced_topics/index) section and read [third-party tutorials](../advanced_topics/third_party_tutorials)

+ 13 - 6
docs/advanced_tutorial/index.md

@@ -1,5 +1,9 @@
 # Tutorial
 
+```{warning}
+We’ve just released this new tutorial. Do you want to provide feedback? Please complete our [2023 tutorial feedback form](https://wagtail.org/gsod-2023-feedback/).
+```
+
 ```{toctree}
 ---
 maxdepth: 2
@@ -14,15 +18,14 @@ add_search
 deployment
 ```
 
+Congratulations on completing [Your first Wagtail site](../getting_started/tutorial.md) tutorial! Now that you've completed the beginner tutorial and built a blog site from scratch, you should have a solid understanding of the basic building blocks of a Wagtail website. We hope you enjoyed learning all about Wagtail.
 
+Now that you can build a blog site with Wagtail, why stop there? We created this extended tutorial to help you grow your Wagtail knowledge.
 
-Congratulations on completing [Your first Wagtail site](../getting_started/tutorial.md) tutorial! Now that you've completed the tutorial and built a blog site from scratch, you should have a solid understanding of the basic building blocks of a Wagtail website. We hope you enjoyed learning all about Wagtail.
-
-Now that you can build a blog site with Wagtail, why stop there? We created this tutorial to help you grow your Wagtail knowledge. 
-
-In this tutorial, you'll transform your blog site into a fully deployable portfolio site. So, you must complete the [Your First Wagtail Site](../getting_started/tutorial.md) tutorial before you begin this Tutorial.
+In this tutorial, you'll transform your blog site into a fully deployable portfolio site. You must first complete the [Your First Wagtail Site](../getting_started/tutorial.md) tutorial before you begin this extended tutorial.
 
 You'll learn the following in this tutorial:
+
 - How to add pagination to your Wagtail website
 - How to use Wagtail StreamField
 - How to use Wagtail documents
@@ -31,4 +34,8 @@ You'll learn the following in this tutorial:
 - How to implement the search feature in a Wagtail website
 - How to deploy a Wagtail website
 
-Now, let's dive in.
+Now, let's dive in.
+
+## Warning: brand new documentation, feedback welcome
+
+We’ve just released this new tutorial. Do you want to provide feedback? Please complete our [2023 tutorial feedback form](https://wagtail.org/gsod-2023-feedback/).

+ 5 - 1
docs/advanced_tutorial/set_up_site_menu.md

@@ -1,5 +1,9 @@
 # Set up site menu for linking to the homepage and other pages
 
+```{warning}
+We’ve just released this new tutorial. Do you want to provide feedback? Please complete our [2023 tutorial feedback form](https://wagtail.org/gsod-2023-feedback/).
+```
+
 This section of the tutorial will teach you how to create a site menu to link to your homepage and other pages as you add them. The site menu will appear across all pages of your portfolio website, just like your footer.
 
 Start by creating a template tag in your `base/templatetags/navigation_tags.py` file:
@@ -86,4 +90,4 @@ You can add any top-level page to the site menu by doing the following:
 4. Check the **Show in menus** checkbox.
 
 In the next section of this tutorial, we'll show you how to style your site and improve its user experience.
-<!-- Provide a diagram to illustrate the checking of the Show in Menu checkbox -->
+<!-- Provide a diagram to illustrate the checking of the Show in Menu checkbox -->

+ 5 - 1
docs/advanced_tutorial/style_your_site.md

@@ -1,5 +1,9 @@
 # Style and improve user experience
 
+```{warning}
+We’ve just released this new tutorial. Do you want to provide feedback? Please complete our [2023 tutorial feedback form](https://wagtail.org/gsod-2023-feedback/).
+```
+
 In this tutorial, you'll add a basic site theme to your portfolio site and improve its user experience. 
 
 ## Add styles
@@ -206,4 +210,4 @@ Finally, go to your `mysite/templates/includes/header.html` and modify it as fol
 
 In the preceding template, you added an `<a> (anchor)` element to create a _Skip to content_ link. You set the `href` attribute to `#main`. The internal anchor links to your base template's `main` element.
 
-Well done! Now, you know how to style a Wagtail site. The next section will teach you how to create a contact page for your portfolio site.
+Well done! Now, you know how to style a Wagtail site. The next section will teach you how to create a contact page for your portfolio site.

+ 1 - 1
docs/getting_started/tutorial.md

@@ -967,7 +967,7 @@ Thank you for reading and welcome to the Wagtail community!
 
 ## Where next
 
--   Read [Tutorial](../advanced_tutorial/index.md) to transform your blog site into a fully deployable portfolio site.
+-   Read our [extended tutorial](../advanced_tutorial/index.md) to transform your blog site into a fully deployable portfolio site.
 -   Read the Wagtail [topics](../topics/index) and [reference](../reference/index) documentation
 -   Learn how to implement [StreamField](../topics/streamfield) for freeform page content
 -   Browse through the [advanced topics](../advanced_topics/index) section and read [third-party tutorials](../advanced_topics/third_party_tutorials)

+ 1 - 0
docs/index.rst

@@ -14,6 +14,7 @@ If you'd like to get a quick feel for Wagtail, try spinning up a `temporary deve
   * :doc:`getting_started/index`
   * :doc:`getting_started/tutorial`
   * :doc:`getting_started/demo_site`
+  * :doc:`advanced_tutorial/index`
 
 * **Using Wagtail**