You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
* [Updated] Linode Writer's Formatting Guide - Before You Begin section
* edited Before You Begin in content.md archetype
* Edits to the Before You Begin section
* Spelling fix
---------
Co-authored-by: Matthew Wildman <matt@wildman.online>
Copy file name to clipboardexpand all lines: archetypes/content.md
+2-6
Original file line number
Diff line number
Diff line change
@@ -17,10 +17,6 @@ When writing content, please reference the [Linode Writer's Formatting Guide](ht
17
17
18
18
## Before You Begin
19
19
20
-
1. If you have not already done so, create a Linode account and Compute Instance. See our [Getting Started on the Linode Platform](/docs/products/platform/get-started/) and [Create a Compute Instance](/docs/products/compute/compute-instances/guides/create/) guides.
20
+
In this section, list out any prerequisites necessary for the reader to complete the guide, including: services or products to be created beforehand, hardware and plan requirements, or software that needs to be preinstalled.
21
21
22
-
1. Follow our [Setting Up and Securing a Compute Instance](/docs/products/compute/compute-instances/guides/set-up-and-secure/) guide to update your system. You may also wish to set the timezone, configure your hostname, create a limited user account, and harden SSH access.
23
-
24
-
{{< note >}}
25
-
The steps in this guide require root privileges. Be sure to run the steps below as `root` or with the `sudo` prefix. For more information on privileges, see our [Linux Users and Groups](/docs/guides/linux-users-and-groups/) guide.
26
-
{{< /note >}}
22
+
See: [Linode Writer's Formatting Guide: Before You Begin](http://www.linode.com/docs/guides/linode-writers-formatting-guide/#before-you-begin)
@@ -74,12 +74,24 @@ Introductions should be concise; explain what the goal of the guide is and why.
74
74
75
75
### Before You Begin
76
76
77
-
The *Before You Begin* section is an area for basic prerequisites a reader should know or have completed before proceeding further in your guide. Use the example below and edit as needed:
77
+
The *Before You Begin* section is used to inform the reader of any prerequisites needed to successfully complete the guide. This may include the following:
78
78
79
-
```file {title="Author Submission"}
79
+
- Specific Akamai services or features that are needed, like Compute Instances, LKE clusters, or Object Storage buckets. This should include any hardware or plan requirements (see [Pricing](https://www.linode.com/pricing/)).
80
+
81
+
- Setup tasks on Akamai services, such as securing a Compute Instance, creating a limited user, configuring a hostname. Only include tasks that are related to the guide and the guide's objective.
82
+
83
+
- External requirements, such as a registered domain name or specific local software (such as a PC running Windows 11).
84
+
85
+
- Software or applications that need to be installed or configured (i.e. LAMP stack, Docker, etc.), making sure to include links to instructions. Only include software that is directly used within the guide, but is not the focus of the guide. If the software needs additional configuration or usage information, it should likely be included in the guide's instructions and not in the *Before You Begin* section.
86
+
87
+
- Foundational knowledge, like an understanding of technology fundamentals (like container orchestration) or specific software or software stacks (like Kubernetes).
88
+
89
+
Below is an example *Before You Begin* section. You may copy the example and edit it as needed:
90
+
91
+
```file {title="Before You Begin"}
80
92
## Before You Begin
81
93
82
-
1. If you have not already done so, create a Linode account and Compute Instance. See our [Getting Started with Linode](/docs/products/platform/get-started/) and [Creating a Compute Instance](/docs/products/compute/compute-instances/guides/create/) guides.
94
+
1. If you do not already have a virtual machine to use, create a Compute Instance with at least 4 GB of memory. See our [Getting Started with Linode](/docs/products/platform/get-started/) and [Creating a Compute Instance](/docs/products/compute/compute-instances/guides/create/) guides.
83
95
84
96
1. Follow our [Setting Up and Securing a Compute Instance](/docs/products/compute/compute-instances/guides/set-up-and-secure/) guide to update your system. You may also wish to set the timezone, configure your hostname, create a limited user account, and harden SSH access.
0 commit comments