forgejo/docs
31
58
Fork
You've already forked docs
249

backport meta commits #15

Merged
earl-warren merged 7 commits from bp/v1.20/meta into v1.20 2023年08月18日 14:10:08 +02:00

A bunch of non-documentation stuff is being added to the repository which will need to be replicated on the release branch. This should not be merged until we are done adding this sort of stuff.

  • Depends on !13
  • Depends on #3
  • Depends on #6
A bunch of non-documentation stuff is being added to the repository which will need to be replicated on the release branch. This should not be merged until we are done adding this sort of stuff. - Depends on !13 - Depends on #3 - Depends on #6
TODO:
- [x] clone from website instead of caesar
- [x] skip the proof of change commit
Preview: https://forgejo.codeberg.page/@docs_pull_5/
This is a simplistic approach to get started with previews. It copies the website, moves the docs under `/forgejo-docs/{{ base branch }}`, create the website and publishes it for preview. No doubt the actual workflow will be different but that needs to be decided.
* Added a WEBSITETOKEN secret created from the forgejo-website user. It is a token with write access to repositories. https://codeberg.org/forgejo/docs/settings/actions/secrets. Contrary to woodpecker it is not in an environment variable but will be replaced when inserting `${{ secrets.WEBSITETOKEN }}` somewhere
* In the environment the variable was replaced CI_COMMIT_PULL_REQUEST → `${{ env.GITHUB_REF_NAME }}`
* The preview is published at https://forgejo.codeberg.page/@docs_pull_N/ instead of https://forgejo.codeberg.page/@pull_N/
* The `$$` were replaced with `$` in the script because Forgejo Actions does not interpret `$` and therefore does not need escaping them to `$$`
Reviewed-on: #5
Reviewed-by: Loïc Dachary <dachary@noreply.codeberg.org>
Reviewed-by: Caesar Schinas <caesar@caesarschinas.com>
Co-authored-by: Earl Warren <contact@earl-warren.org>
Co-committed-by: Earl Warren <contact@earl-warren.org>
TODO:
- [x] comment out the `git push` once the website has submodules merged in
Fixes: #8
Additionally
* Upgrade to node:20
* Exclude the README.md when copying to the preview
* Allow forgejo-website to push to main on website
![image](/attachments/14f4f38f-fdb8-4ca7-9aee-d9b7e108d71e)
Preview: https://forgejo.codeberg.page/@docs_pull_9/
Reviewed-on: #9
Reviewed-by: Loïc Dachary <dachary@noreply.codeberg.org>
Co-authored-by: Earl Warren <contact@earl-warren.org>
Co-committed-by: Earl Warren <contact@earl-warren.org>
Add "internal" pull request instructions
All checks were successful
pr / preview (pull_request) Successful in 43s
d24c776781
add linting for docs markdown content
All checks were successful
pr / preview (pull_request) Successful in 36s
f2392e3c1e
Author
Owner
Copy link

I will use this comment to keep a list of non-meta PRs that need to be backported after this is merged.

I will use this comment to keep a list of non-meta PRs that need to be backported after this is merged. - https://codeberg.org/forgejo/docs/pulls/17 - https://codeberg.org/forgejo/docs/pulls/19
Member
Copy link

Does it matter if they're backported before or after this?

Does it matter if they're backported before or after this?
Author
Owner
Copy link

Not particularly. You may backport them now if you like, it will just require manual deployment and a rebase of this PR.

Not particularly. You may backport them now if you like, it will just require manual deployment and a rebase of this PR.
add a comment with a link to the preview on creation
All checks were successful
pr / preview (pull_request) Successful in 34s
push / publish (push) Successful in 6s
b270642d73
Refs: #3
(cherry picked from commit 5dde3a4231)
Ghost approved these changes 2023年08月17日 19:41:35 +02:00
Collaborator
Copy link
Preview ready: https://forgejo.codeberg.page/@docs_pull_15/
Contributor
Copy link

Depends on #6

Not resolved yet but I suppose it can be resolved later.

> Depends on #6 Not resolved yet but I suppose it can be resolved later.
earl-warren changed title from (削除) WIP: Backport meta commits (削除ここまで) to backport meta commits 2023年08月18日 14:09:56 +02:00
earl-warren deleted branch bp/v1.20/meta 2023年08月18日 14:10:08 +02:00
Sign in to join this conversation.
No reviewers
Labels
Clear labels
404
Broken links or missing content
backport/v1.19
Changes which should be backported to the v1.19 docs

Archived

backport/v1.20
Changes which should be backported to the v1.20 docs

Archived

backport/v1.21
Changes which should be backported to the v1.21 docs

Archived

backport/v10.0
Automated backport to v10.0

Archived

backport/v11.0
Automated backport to v11.0
backport/v12.0
Automated backport to v12.0

Archived

backport/v13.0
Automated backport to v13.0

Archived

backport/v14.0
Automated backport to v14.0

Archived

backport/v15.0
Automated backport to v15.0
backport/v16.0
Automated backport to v16.0
backport/v7.0
Automated backport to the v7.0 docs

Archived

backport/v8.0
Automated backport to the v8.0 docs

Archived

backport/v9.0
Automated backport to the v9.0 docs

Archived

good first issue
This issue is suitable for "drive-by contributors" wanting to contribute for the first time, and fixing it should be straightforward.
meta
Tooling and processes for maintaining the docs
new docs
Content to be added to the documentation

Archived

User research - Accessibility
Requires input about accessibility features, likely involves user testing.
User research - Blocked
Do not pick as-is! We are happy if you can help, but please coordinate with ongoing redesign in this area.
User research - Community
Community features, such as discovering other people's work or otherwise feeling welcome on a Forgejo instance.
User research - Config (instance)
Instance-wide configuration, authentication and other admin-only needs.
User research - Errors
How to deal with errors in the application and write helpful error messages.
User research - Filters
How filter and search is being worked with.
User research - Future backlog
The issue might be inspiring for future design work.
User research - Git workflow
AGit, fork-based and new Git workflow, PR creation etc
User research - Labels
Active research about Labels
User research - Moderation
Moderation Featuers for Admins are undergoing active User Research
User research - Needs input
Use this label to let the User Research team know their input is requested.
User research - Notifications/Dashboard
Research on how users should know what to do next.
User research - Rendering
Text rendering, markup languages etc
User research - Repo creation
Active research about the New Repo dialog.
User research - Repo units
The repo sections, disabling them and the "Add more" button.
User research - Security
User research - Settings (in-app)
How to structure in-app settings in the future?
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
5 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
forgejo/docs!15
Reference in a new issue
forgejo/docs
No description provided.
Delete branch "bp/v1.20/meta"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?