Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Comparison: Cloudflare Pages #229

Merged
merged 4 commits into from
Sep 12, 2023
Merged

Conversation

humitos
Copy link
Member

@humitos humitos commented Sep 8, 2023

Create a comparison page for Cloudflare Pages:
https://pages.cloudflare.com/
@humitos humitos requested a review from a team as a code owner September 8, 2023 17:39
@humitos humitos self-assigned this Sep 8, 2023
We are talking about "Documentation projects" more than a Blog :)
content/includes/try-it-out-pelican.html Show resolved Hide resolved
Comment on lines 23 to 29
Cloudflare Pages is great for hosting SPA (<em>Single Page Application</em>) for frontend developers.
However, when talking about <strong>technical writers</strong> and <strong>documentation projects</strong>,
Read the Docs is <em>the</em> perfect solution.
</p>
<p>
Let's compare it to know what you can expect when deploying your project's documentation to Read the Docs.
</p>
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Cloudflare Pages is great for hosting SPA (<em>Single Page Application</em>) for frontend developers.
However, when talking about <strong>technical writers</strong> and <strong>documentation projects</strong>,
Read the Docs is <em>the</em> perfect solution.
</p>
<p>
Let's compare it to know what you can expect when deploying your project's documentation to Read the Docs.
</p>
Cloudflare Pages is great for hosting a SPA (<em>Single Page Application</em>).
However, when talking about <strong>software documentation projects</strong>,
Read the Docs is <em>the</em> perfect solution.
</p>
<p>
Understand the benefits of deploying your project's documentation to Read the Docs.
</p>

Copy link
Member Author

@humitos humitos Sep 12, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hrm, your suggestion is good. However, I'd like to keep "technical writers" somehow in the sentence because I want to rank on it --I put it there on purpose. We are not mentioning that role enough and we have been focusing us more in "developers" without reaching many technical writers.

Also, "Cloudflare pages is for frontend developers" is a concept that works great to me because the reader will immediately realize that Cloudflare is not for them. It's the way they sell themselves:

Screenshot_2023-09-12_11-02-38

which makes sense since they allow creating some kind of APIs.

Also also, I'd like to leave the "documentation projects" as-is, since we already have customers documenting other type of projects that are not software. Like hardware, for example.

I'll take some parts of this suggestion. However, I'd really appreciate your thoughts here about my points to continue the conversation. After that, we can change this paragraph in a following PR 👍🏼

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Makes sense. I was mostly just trying to cleanup the language and couldn't find a good way to keep it in there, but fine with keeping it 👍

I took my own decision here, but we can upgrade this paragraph :)
@humitos humitos merged commit 7b9566f into main Sep 12, 2023
4 checks passed
@humitos humitos deleted the humitos/comparison-cloudflare-pages branch September 12, 2023 09:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
Archived in project
Development

Successfully merging this pull request may close these issues.

2 participants