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
Copy file name to clipboardexpand all lines: CONTRIBUTING.md
+43-2
Original file line number
Diff line number
Diff line change
@@ -19,10 +19,51 @@ Try to encourage newcomers to express their opinions and make them comfortable e
19
19
To submit a new theme, you need to follow these steps:
20
20
21
21
1. Create a new repository based on the [template](https://github.com/getomni/template).
22
-
1.1. The branch name must be `main` (we will keep this name pattern from now on).
22
+
a) The branch name must be `main` (we will keep this name pattern from now on).
23
+
b) The repository name must be lowercase and contain just the application name. E.g. `visual-studio-code`.
23
24
2. Build the new theme using the [Omni Color Palette](https://github.com/getomni/omni#color-palette).
24
25
3. Submit an issue with the link to your repository. Once the theme is accepted, we will move the repository under the Omni organization.
25
26
4. Open a PR to add the theme to the main repository (this one). Add it under its respective category (if it doesn't exist, you can create one). Also, make sure it is in alphabetical order.
26
-
4.1. Update the total number of applications supported in the README.
27
+
a) Update the total number of applications supported in the README.
27
28
5. Finally, after your theme is under the organization, update all links to match the new repository URL.
28
29
6. Spread the word by tweeting about your new theme and encouraging others to try it out.
30
+
31
+
## Maintaining a theme
32
+
33
+
After your theme is under the Omni organization, you're responsible for maintaining it. It's your responsibility to answer issues, review PR's and always keep it up-to-date.
34
+
35
+
Below you can find some guidelines that we follow:
36
+
37
+
- Always open pull requests when updating the theme (the `main` branch is protected by default);
38
+
- Review issues and PRs periodically;
39
+
- When you're going to add a new theme maintainer, add it in the README (team section) and the CODEOWNERS file;
40
+
- Share the theme on forums, Twitter and communities, to spread the word about your theme;
41
+
- In case you have any questions, reach out to [João Pedro Schmitz](https://github.com/jpedroschmitz).
42
+
43
+
## For organization owners
44
+
45
+
This section is for owners of the Omni organization in GitHub. It covers guides on how to add a new theme and some responsibilities.
46
+
47
+
### Adding new theme
48
+
49
+
To add a new theme to the organization, you need to review the proposed theme and make sure it follows the template and the color pallete.
50
+
51
+
When the theme is ready to be added to the organization, you need to:
52
+
53
+
1. Create a new team on the organization for the application;
54
+
a) The team name is the application name;
55
+
b) The team description is the application name + "theme maintainers";
56
+
c) Remove yourself as a member (if you created it, don't do so).
57
+
2. Invite the theme creator to that team and ask to transfer the repository;
58
+
3. When the transfer is completed, add the repository to the created team;
59
+
a) Set the repository permission to `write`.
60
+
4. Go to the theme repository and then:
61
+
a) Disable wikis and projects (we don't use them);
62
+
b) Disable packages (in the same place where we change description);
63
+
c) Add tags (theme, omni, omni-theme, <tool>);
64
+
d) Add description (🎨 Omni for <tool>);
65
+
e) Add Open Graph Image (this is the [Figma link](https://www.figma.com/file/LJRny1i7eOagTXO4Her5u7/Omni-Project/duplicate), use it to generate an image);
66
+
f) Add protection rule for the `main` branch (check the `Require pull request reviews before merging` and `Require review from Code Owners`);
67
+
g) Close the issue and add a `transfer-completed` label;
68
+
h) Ask the owner to add the new theme on the main repo;
0 commit comments