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

Update content for 4.0 (part 1) #991

Merged
merged 156 commits into from
Nov 20, 2022
Merged

Update content for 4.0 (part 1) #991

merged 156 commits into from
Nov 20, 2022

Conversation

trwnh
Copy link
Member

@trwnh trwnh commented Nov 8, 2022

This PR contains most of what was added or changed but not documented since about 3.3 or 3.4.

Anything not yet documented is marked with a TODO: comment. This mostly includes:

  • /api/v2/filters
  • /api/v1/admin/canonical_email_blocks
  • /api/v1/admin/trends

These will be updated in a follow-up PR; I am submitting this one now in the interest of preventing merge conflicts with other PRs which largely attempt to fix things I've already fixed.

#982 seems like a good idea to merge as well, given that I tested the site with Hugo v0.105.0+extended

Also worth noting is that API methods pages have been refactored to use more accessible markdown (notably, definition lists instead of tables) that should reflow to mobile widths much better, although the shortcodes for the old API method blocks have not been removed at this time.

Before After
image image
image image

One other thing worth noting: there are proper anchor links to sections now, so you can easily link to a specific section on a page

Test deploy: https://master--mastodocs-991.netlify.app/


## Manual install from source {#manual}

You can follow the [pre-requisites instructions from the production guide]({{<relref "admin/install">}}), but do not create a `mastodon` user. You also don't have to install `nginx`, `certbot` and `python-certbot-nginx` as the development environment brings its own webserver. Setting up and running a development environment has been proven successful over WSL2 as well if you are on Windows.

Choose a reason for hiding this comment

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

We should rewrite this paragraph, as new contributor it's not really clear

Copy link
Member Author

Choose a reason for hiding this comment

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

What would help make it more clear?

Choose a reason for hiding this comment

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

I will try to make a little review

@trwnh trwnh mentioned this pull request Nov 18, 2022
@Gargron Gargron merged commit 3628b6d into mastodon:master Nov 20, 2022
@andypiper
Copy link
Sponsor Member

Huge update, thanks for this @trwnh ❤️

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

5 participants