self-hosted/focalboard
1
0
Fork 0
mirror of https://github.com/mattermost/focalboard.git synced 2024-12-21 13:38:56 +02:00
Code Issues Releases Activity

Merge pull request #4984 from azigler/azigler-fy25-messaging

Browse Source 
📝 docs(README.md): Update project status and contribution guidelines
This commit is contained in:
Joram Wilander 2024-02-22 11:53:38 -05:00 committed by GitHub
commit 7a31925d8a
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
3 changed files with 64 additions and 111 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

61
CONTRIBUTING.md
View File

@ -1,47 +1,20 @@
# Code Contribution Guidelines # Disclaimer
Thank you for your interest in contributing! Please read the [Focalboard Contribution Guide](https://developers.mattermost.com/contribute/focalboard/) to learn the process for making code contributions, and [join our Focalboard community channel](https://community.mattermost.com/core/channels/focalboard) to get help from community members and the core team. > [!WARNING]
> **Effective September 15th, 2023, Mattermost, Inc. staff are no longer reviewing or merging pull requests for either Focalboard or the Mattermost Boards plugin in this repository (`mattermost/focalboard`). We encourage the community to fork this repository for continued development and contributions.**
>
> The reason behind these changes is to focus Mattermost developer resources on improving the platform’s performance and core features to ensure Mattermost continues being resilient, stable, and best-in-breed for critical operations.
>
> ️💡 [Learn more](https://forum.mattermost.com/t/upcoming-product-changes-to-boards-and-various-plugins/16669)
When you submit a pull request, it goes through a code review process outlined [here](https://developers.mattermost.com/contribute/getting-started/code-review/). ## Past maintainers
After a noteable bug fix or improvement is merged, submit a pull request to the [CHANGELOG](CHANGELOG.md) under the next release section. - **Scott Bishel**: [@sbishel](https://github.com/sbishel)
- **Jesús Espino**: [@jespino](https://github.com/jespino)
## Bug Reports - **Doug Lauder**: [@wiggin77](https://github.com/wiggin77)
- **Miguel de la Cruz**: [@mgdelacroix](https://github.com/mgdelacroix)
Please file a [GitHub issue](https://github.com/mattermost/focalboard/issues) if anything isn't working the way you expect. - **Harshil Sharma**: [@harshilsharma63](https://github.com/harshilsharma63)
- **Chen Lim**: [@chenilim](https://github.com/chenilim)
## Documentation - **Ogi Marušić**: [@ogi-m](https://github.com/ogi-m)
- **Winson Wu**: [@wuwinson](https://github.com/wuwinson)
You can contribute to the [Mattermost Boards documentation](https://docs.mattermost.com/guides/boards.html). Read more about how the contribution process works in the repository's [README](https://github.com/mattermost/docs/blob/master/README.md). Visit the [Documentation Working Group channel](https://community.mattermost.com/core/channels/dwg-documentation-working-group) on our community server if you have any questions! - **Justine Geffen**: [@justinegeffen](https://github.com/justinegeffen)
## Contributors
**Core Committers**: Maintains the Focalboard project and has merge access to the repositories. They are responsible for reviewing pull requests, cultivating the developer community, and guiding the technical vision of Focalboard. If you have a question or need some help, these are the people to ask.
- **<a name="scott.bishel">Scott Bishel</a>**
- @scott.bishel on [community.mattermost.com](https://community.mattermost.com/core/messages/@scott.bishel) and [@sbishel](https://github.com/sbishel) on GitHub
- **<a name="jesús.espino">Jesús Espino</a>**
- @jesus.espino on [community.mattermost.com](https://community.mattermost.com/core/messages/@jesus.espino) and [@jespino](https://github.com/jespino) on GitHub
- **<a name="doug.lauder">Doug Lauder</a>**
- @doug.lauder on [community.mattermost.com](https://community.mattermost.com/core/messages/@doug.lauder) and [@wiggin77](https://github.com/wiggin77) on GitHub
- **<a name="miguel.delacruz">Miguel de la Cruz</a>**
- @miguel.delacruz on [community.mattermost.com](https://community.mattermost.com/core/messages/@miguel.delacruz) and [@mgdelacroix](https://github.com/mgdelacroix) on GitHub
- **<a name="harshil.sharma">Harshil Sharma</a>**
- @harshil.sharma on [community.mattermost.com](https://community.mattermost.com/core/messages/@harshil.sharma) and [@harshilsharma63](https://github.com/harshilsharma63) on GitHub
- **<a name="chen.lim">Chen Lim</a>**
- @chen-i.lim on [community.mattermost.com](https://community.mattermost.com/core/messages/@chen-i.lim) and [@chenilim](https://github.com/chenilim) on GitHub
**Quality Assurance**: Checks quality of code and verifies bug fixes.
- **<a name="ogi.marusic">Ogi Marušić</a>**
- @ogi.marusic on [community.mattermost.com](https://community.mattermost.com/core/messages/@ogi.marusic) and [@ogi-m](https://github.com/ogi-m) on GitHub
**Community Organizers**: Responds with comments to bug reports, issues, and pull requests with tags, edits and mentions to core committers and contributors.
- **<a name="winson.wu">Winson Wu</a>**
- @winson.wu on [community.mattermost.com](https://community.mattermost.com/core/messages/@winson.wu) and [@wuwinson](https://github.com/wuwinson) on GitHub
**Documentation**: Verifies documentation changes and updates documentation for new features.
- **<a name="justine.geffen">Justine Geffen</a>**
- @justine.geffen on [community.mattermost.com](https://community.mattermost.com/core/messages/@justine.geffen) and [@justinegeffen ](https://github.com/justinegeffen) on GitHub

106
README.md
View File

@ -1,12 +1,9 @@
# Disclaimer > [!WARNING]
> **Effective September 15th, 2023, Mattermost, Inc. staff are no longer reviewing or merging pull requests for either Focalboard or the Mattermost Boards plugin in this repository (`mattermost/focalboard`). We encourage the community to fork this repository for continued development and contributions.**
**This repository is community supported and not maintained by Mattermost. Mattermost disclaims liability for integrations, including Third Party Integrations and Mattermost Integrations. Integrations may be modified or discontinued at any time.** >
> The reason behind these changes is to focus Mattermost developer resources on improving the platform’s performance and core features to ensure Mattermost continues being resilient, stable, and best-in-breed for critical operations.
Effective September 15th, 2023, the Focalboard plugin is no longer bundled with Mattermost and has transitioned to being fully community supported. Self-hosted Mattermost instances may continue to use the Focalboard plugin without interruption; however, Mattermost developers will not be adding any new enhancements or bug fixes beyond September 15th, 2023. This Focalboard repository will remain open indefinitely for contributions from the open source community. >
> ️💡 [Learn more](https://forum.mattermost.com/t/upcoming-product-changes-to-boards-and-various-plugins/16669)
The reason behind these changes is to focus Mattermost developer resources on improving the platform’s performance and core features to ensure Mattermost continues being resilient, stable, and best-in-breed for critical operations.
You can [learn more about these changes in our forum](https://forum.mattermost.com/t/upcoming-product-changes-to-boards-and-various-plugins/16669).
# Focalboard # Focalboard
@ -14,11 +11,6 @@ You can [learn more about these changes in our forum](https://forum.mattermost.c
![CodeQL](https://github.com/mattermost/focalboard/actions/workflows/codeql-analysis.yml/badge.svg) ![CodeQL](https://github.com/mattermost/focalboard/actions/workflows/codeql-analysis.yml/badge.svg)
![Dev Release](https://github.com/mattermost/focalboard/actions/workflows/dev-release.yml/badge.svg) ![Dev Release](https://github.com/mattermost/focalboard/actions/workflows/dev-release.yml/badge.svg)
![Prod Release](https://github.com/mattermost/focalboard/actions/workflows/prod-release.yml/badge.svg) ![Prod Release](https://github.com/mattermost/focalboard/actions/workflows/prod-release.yml/badge.svg)
<a href="https://translate.mattermost.com/engage/focalboard/">
<img src="https://translate.mattermost.com/widgets/focalboard/-/svg-badge.svg" alt="Translation status" />
</a>
Like what you see? :eyes: Give us a GitHub Star! :star:
![Focalboard](website/site/static/img/hero.jpg) ![Focalboard](website/site/static/img/hero.jpg)
@ -36,7 +28,7 @@ It helps define, organize, track and manage work across individuals and teams. F
### Mattermost Plugin ### Mattermost Plugin
After downloading and installing the plugin in the System Console, select the menu in the top left corner and select **Boards**. Access the latest releases of the focalboard plugin by downloading the `mattermost-plugin-focalboard.tar.gz` file from the releases in this repository: https://github.com/mattermost/focalboard/releases After downloading and installing the plugin in the System Console, select the menu in the top left corner and select **Boards**. Access the latest releases of the focalboard plugin by downloading the `mattermost-plugin-focalboard.tar.gz` file from the releases in this repository: <https://github.com/mattermost/focalboard/releases>
### Personal Desktop (Windows, Mac or Linux Desktop) ### Personal Desktop (Windows, Mac or Linux Desktop)
@ -50,15 +42,11 @@ After downloading and installing the plugin in the System Console, select the me
### API Docs ### API Docs
Boards API docs can be found over at https://htmlpreview.github.io/?https://github.com/mattermost/focalboard/blob/main/server/swagger/docs/html/index.html Boards API docs can be found over at <https://htmlpreview.github.io/?https://github.com/mattermost/focalboard/blob/main/server/swagger/docs/html/index.html>
## Contribute to Focalboard
For anyone interested in being an official maintainer of the Focalboard repository, please reach out to us on our [Focalboard Community Channel](https://community.mattermost.com/core/channels/focalboard). If there are no maintainers, and you’re still interested in adding your own improvements to the Focalboard Personal Editions, we encourage you to fork and maintain the repository.
### Getting started ### Getting started
Our [developer guide](https://developers.mattermost.com/contribute/focalboard/personal-server-setup-guide) has detailed instructions on how to set up your development environment for the **Personal Server**. It also provides more information about contributing to our open source community. Our [developer guide](https://developers.mattermost.com/contribute/focalboard/personal-server-setup-guide) has detailed instructions on how to set up your development environment for the **Personal Server**. You can also join the [~Focalboard community channel](https://community.mattermost.com/core/channels/focalboard) to connect with other developers.
Clone [mattermost-server](https://github.com/mattermost/mattermost-server) into sibling directory. Clone [mattermost-server](https://github.com/mattermost/mattermost-server) into sibling directory.
@ -90,38 +78,38 @@ Once the server is running, you can rebuild just the web app via `make webapp` i
You can build standalone apps that package the server to run locally against SQLite: You can build standalone apps that package the server to run locally against SQLite:
* **Windows**: * **Windows**:
* *Requires Windows 10, [Windows 10 SDK](https://developer.microsoft.com/en-us/windows/downloads/sdk-archive/) 10.0.19041.0, and .NET 4.8 developer pack* * *Requires Windows 10, [Windows 10 SDK](https://developer.microsoft.com/en-us/windows/downloads/sdk-archive/) 10.0.19041.0, and .NET 4.8 developer pack*
* Open a `git-bash` prompt. * Open a `git-bash` prompt.
* Run `make prebuild` * Run `make prebuild`
* The above prebuild step needs to be run only when you make changes to or want to install your npm dependencies, etc. * The above prebuild step needs to be run only when you make changes to or want to install your npm dependencies, etc.
* Once the prebuild is completed, you can keep repeating the below steps to build the app & see the changes. * Once the prebuild is completed, you can keep repeating the below steps to build the app & see the changes.
* Run `make win-wpf-app` * Run `make win-wpf-app`
* Run `cd win-wpf/msix && focalboard.exe` * Run `cd win-wpf/msix && focalboard.exe`
* **Mac**: * **Mac**:
* *Requires macOS 11.3+ and Xcode 13.2.1+* * *Requires macOS 11.3+ and Xcode 13.2.1+*
* Run `make prebuild` * Run `make prebuild`
* The above prebuild step needs to be run only when you make changes to or want to install your npm dependencies, etc. * The above prebuild step needs to be run only when you make changes to or want to install your npm dependencies, etc.
* Once the prebuild is completed, you can keep repeating the below steps to build the app & see the changes. * Once the prebuild is completed, you can keep repeating the below steps to build the app & see the changes.
* Run `make mac-app` * Run `make mac-app`
* Run `open mac/dist/Focalboard.app` * Run `open mac/dist/Focalboard.app`
* **Linux**: * **Linux**:
* *Tested on Ubuntu 18.04* * *Tested on Ubuntu 18.04*
* Install `webgtk` dependencies * Install `webgtk` dependencies
* Run `sudo apt-get install libgtk-3-dev` * Run `sudo apt-get install libgtk-3-dev`
* Run `sudo apt-get install libwebkit2gtk-4.0-dev` * Run `sudo apt-get install libwebkit2gtk-4.0-dev`
* Run `make prebuild` * Run `make prebuild`
* The above prebuild step needs to be run only when you make changes to or want to install your npm dependencies, etc. * The above prebuild step needs to be run only when you make changes to or want to install your npm dependencies, etc.
* Once the prebuild is completed, you can keep repeating the below steps to build the app & see the changes. * Once the prebuild is completed, you can keep repeating the below steps to build the app & see the changes.
* Run `make linux-app` * Run `make linux-app`
* Uncompress `linux/dist/focalboard-linux.tar.gz` to a directory of your choice * Uncompress `linux/dist/focalboard-linux.tar.gz` to a directory of your choice
* Run `focalboard-app` from the directory you have chosen * Run `focalboard-app` from the directory you have chosen
* **Docker**: * **Docker**:
* To run it locally from offical image: * To run it locally from offical image:
* `docker run -it -p 80:8000 mattermost/focalboard` * `docker run -it -p 80:8000 mattermost/focalboard`
* To build it for your current architecture: * To build it for your current architecture:
* `docker build -f docker/Dockerfile .` * `docker build -f docker/Dockerfile .`
* To build it for a custom architecture (experimental): * To build it for a custom architecture (experimental):
* `docker build -f docker/Dockerfile --platform linux/arm64 .` * `docker build -f docker/Dockerfile --platform linux/arm64 .`
Cross-compilation currently isn't fully supported, so please build on the appropriate platform. Refer to the GitHub Actions workflows (`build-mac.yml`, `build-win.yml`, `build-ubuntu.yml`) for the detailed list of steps on each platform. Cross-compilation currently isn't fully supported, so please build on the appropriate platform. Refer to the GitHub Actions workflows (`build-mac.yml`, `build-win.yml`, `build-ubuntu.yml`) for the detailed list of steps on each platform.
@ -134,24 +122,8 @@ Before checking in commits, run `make ci`, which is similar to the `.gitlab-ci.y
* **Web app unit tests**: `cd webapp; npm run test` * **Web app unit tests**: `cd webapp; npm run test`
* **Web app UI tests**: `cd webapp; npm run cypress:ci` * **Web app UI tests**: `cd webapp; npm run cypress:ci`
### Translating
Help translate Focalboard! The plugin is already translated into several languages. We welcome corrections and new language translations submitted against the [appropriate language JSON file](https://github.com/mattermost/focalboard/tree/main/webapp/i18n) in this repository. To add a new language, follow the steps below:
- Create a new file with the language code (I.E. `en.json`) inside `webapp/i18n` directory
- Copy the contents of the en.json file into your newly created file
- Leave the keys in this file as they are and replace all the values with the translated strings
- Go to `webapp/src/constants.ts` and add an entry for the language you are translating into under the **languages** array
- This array needs to consist of three keys: the language code, the name of the language and the display name of the language
- Go to `webapp/src/i18n.tsx`:
- import the json of the language translation you have just added
- Add the language code to the `supportedLanguages` array
- Add another case to the switch case matching the language you added inside `getMessages`
- Once you are done, you need to update the snapshot by using this command `npm run updatesnapshot`
### Staying informed ### Staying informed
* **Changes**: See the [CHANGELOG](CHANGELOG.md) for the latest updates * **Changes**: See the [CHANGELOG](CHANGELOG.md) for the latest updates
* **GitHub Discussions**: Join the [Developer Discussion](https://github.com/mattermost/focalboard/discussions) board
* **Bug Reports**: [File a bug report](https://github.com/mattermost/focalboard/issues/new?assignees=&labels=bug&template=bug_report.md&title=) * **Bug Reports**: [File a bug report](https://github.com/mattermost/focalboard/issues/new?assignees=&labels=bug&template=bug_report.md&title=)
* **Chat**: Join the [Focalboard community channel](https://community.mattermost.com/core/channels/focalboard) * **Chat**: Join the [~Focalboard community channel](https://community.mattermost.com/core/channels/focalboard)

8
docs/README.md Normal file
View File

@ -0,0 +1,8 @@
# Disclaimer
> [!WARNING]
> **Effective September 15th, 2023, Mattermost, Inc. staff are no longer reviewing or merging pull requests for either Focalboard or the Mattermost Boards plugin in this repository (`mattermost/focalboard`). We encourage the community to fork this repository for continued development and contributions.**
>
> The reason behind these changes is to focus Mattermost developer resources on improving the platform’s performance and core features to ensure Mattermost continues being resilient, stable, and best-in-breed for critical operations.
>
> ️💡 [Learn more](https://forum.mattermost.com/t/upcoming-product-changes-to-boards-and-various-plugins/16669)