Does this sound familiar? You get to an application page. All you see is advice on how to use the application with Apache and Nginx or some other webserver, but nothing for Caddy.
Want to help transform the application landscape and get the Caddy message out there? You’ll be helping Caddy users who follow in your footsteps as well as bring Caddy to the attention of other users.
There’s been some work done on a recommended process to follow to spread the Caddy word. If you want to find out more, check the references at the bottom of this wiki article. Here’s the process in a nutshell. There are generally four and sometimes five steps.
- Find an application page you want to make Caddy ready.
- Discuss your approach in a Caddy forum thread.
- Optionally, summarise the result in a Caddy wiki article.
- Update the register of Caddy ready application pages.
- Lobby to have Caddy referenced on the application page.
Step 1: Find an application page you want to make Caddy ready
This one’s easy. You’re probably already there. You’ve found an article which references another, or other webservers and you need help figuring out how to use it with Caddy.
Step 2: Discuss your approach in a Caddy forum thread
You’re well supported! Reference the article in a help thread in the Caddy forum. Use the thread to seek help, from the Caddy community and core maintainers, on any required Caddy code design. Make sure you test out the code in the context of the article. You may wish to discuss the changes you’re proposing for the article.
Tip: Use whatever tools are at your fingertips to help you articulate in posts what you’re trying to achieve e.g. use code and text extracts, logs, screenshots, references and links etc. Do remember that the Caddy folk are experts on Caddy and not necessarily experts with the application you’re working with.
Step 3: Optionally, summarise the result in a Caddy wiki article
This step is appropriate in particular situations such as when the application page centres on a single proxy server, or, the Caddy solution has a degree of complexity.
Step 4: Update the register of Caddy ready application pages
Now, a bit of housekeeping. As Caddy evolves, new keywords may be introduced, existing keywords may be deprecated or become defunct. A register will help track down Caddy code in application pages that may need to be updated. Remember to add an entry to the Register (see below).
Step 5: Lobby to have Caddy referenced on the application page
Contact the application document team to have Caddy referenced on the application page. This is the tricky step. So far, you’ve been in control. In this step, you’re relying on an external party to make the necessary changes to the article for you. It may require you to develop and nurture a relationship with the application document team. Once you’ve figured out how to get an article updated, add directions to the Directory (see below) for other contributors (terraformers ) to follow.
Directory
Contact Directory | |
---|---|
Application | Notes |
WordPress | The documentation team holds weekly office hours on Tuesdays from 14:00-15:00 UTC in the #docs Slack channel. Submit requests for doc updates here Issues · WordPress/Documentation-Issue-Tracker · GitHub. The documentation team will consider linking to Caddy wiki articles. They will reject merging Caddy snippets within WordPress support articles. |
Register
Linode | |||
---|---|---|---|
# | External Reference | Forum reference | Article updated |
1 |
MDN | |||
---|---|---|---|
# | External Reference | Forum reference | Article updated |
1 |
Symfony | |||
---|---|---|---|
# | External Reference | Forum reference | Article updated |
1 | Configuring a Web Server (Symfony Docs) | Configuring a Caddy webserver for Symfony |
Template | |||
---|---|---|---|
# | External Reference | Forum reference | Article updated |
1 |
Add a post for an application you would like to see more Caddy examples for. Vote for more Caddy examples for an application by liking its post below.