diff --git a/docs/DeveloperDocs/Design-Principles.md b/docs/DeveloperDocs/Design-Principles.md index c94995b5e..04ba5d308 100644 --- a/docs/DeveloperDocs/Design-Principles.md +++ b/docs/DeveloperDocs/Design-Principles.md @@ -1,23 +1,35 @@ ## WeKan Design Principles -- Prevent messing up something https://github.com/wekan/wekan/wiki/Monkey-Proof-Software -- Original WeKan Design, that WeKan currently has: Intuitive, easy to figure out, polished UI/UX, menu options are there where you would expect then to be. Try to fix anything unexpected. New features added there where it makes most sense. And not so many duplicate menus and texts like Trello. -- Not the exact design of Trello https://github.com/wekan/wekan/wiki/FAQ#why-does-wekan-look-so-different-now-compared-to--v09 . Also not the exact design of any other software. But note that design of all software changes often, when they are in active development. -- Some features like Trello: +- 2024-08 Design discussion here: https://github.com/wekan/wekan/discussions/5507 +- Original WeKan Design: + - Kanban, the good parts. Like was done when figuring out best design for Swimlanes https://github.com/wekan/wekan/issues/955 + - Intuitive, easy to figure out, prevent messing up something https://github.com/wekan/wekan/wiki/Monkey-Proof-Software + - Polished UI/UX + - Menu options are there where you would expect then to be. + - Try to fix anything unexpected. + - New features added there where it makes most sense. + - FOSS with MIT license + - Swimlanes + - All the use cases of WeKan feature/fix contributors + - Cross-platform. Support many CPU/OS/Browsers for Desktop and Mobile. + - Support many browsers https://github.com/wekan/wekan/wiki/Browser-compatibility-matrix . Add support for more. + - PWA https://github.com/wekan/wekan/wiki/PWA + - On-Premise: + - Linux amd64/arm64/s390x + - https://wekan.github.io/install/ + - https://github.com/wekan/wekan/wiki/Raspberry-Pi + - Windows https://github.com/wekan/wekan/wiki/Offline + - Mac https://github.com/wekan/wekan/wiki/Mac +- Not like other software: + - But note that design of all software changes often, when they are in active development. +- Not bad parts of Trello: + - Not the exact design of Trello https://github.com/wekan/wekan/wiki/FAQ#why-does-wekan-look-so-different-now-compared-to--v09 + - Not so many duplicate menus and texts like Trello + - Not so much empty space +- Some good parts of Trello: - Import from Trello - Shortcuts https://github.com/wekan/wekan/issues/1878 - IFTTT Rules like Trello Butler https://github.com/wekan/wekan/wiki/IFTTT - Progress bar of checklist -- Some features like Jira: - - Multiple assignees -- Some features not in Trello, like: - - FOSS with MIT license - - Self-hosting - - Swimlanes -- All the use cases of WeKan feature/fix contributors -- Cross-platform. Support many CPU/OS/Browsers for Desktop and Mobile. Add support for more. - - https://github.com/wekan/wekan/wiki/Browser-compatibility-matrix - - https://github.com/wekan/wekan/wiki/PWA - - https://github.com/wekan/wekan/wiki/Offline - - https://github.com/wekan/wekan/wiki/Mac - - https://github.com/wekan/wekan/wiki/Raspberry-Pi \ No newline at end of file +- Some good parts of Jira: + - Multiple assignees \ No newline at end of file diff --git a/docs/DeveloperDocs/Meteor.md b/docs/DeveloperDocs/Meteor.md index a16f03e71..8bda65362 100644 --- a/docs/DeveloperDocs/Meteor.md +++ b/docs/DeveloperDocs/Meteor.md @@ -1,11 +1,49 @@ +## Meteor 3 Example Code + +- https://github.com/fredmaiaarantes/simpletasks + - MIT License + - https://github.com/xet7/simpletasks +- https://github.com/henriquealbert/meteor-with-prisma + - MIT License + - https://github.com/xet7/meteor-with-prisma +- https://github.com/henriquealbert/meteor-pnpm + - MIT License + - https://github.com/xet7/meteor-pnpm + +## Building Multi Platform Mobile Apps + +- TWIM 058: Building Multi Platform Mobile Apps https://www.youtube.com/watch?v=ZTtXRJTUCIU +- https://www.youtube.com/watch?v=ZTtXRJTUCIU +- https://github.com/jamauro/pwa-kit +- https://wekan.team/app/ +- https://github.com/wekan/wekan/wiki/PWA +- Over 100 icons for different platforms https://github.com/wekan/wekan/blob/main/public/site.webmanifest + +## Tip to any programmers + +- Try to understand any error messages, and what to do to those errors + ## Videos about upgrading to Meteor 3 - Storyteller + - Upcoming: + - 2024-09-02: Meteor.js generators https://www.youtube.com/watch?v=Z6nY2wqPgSE + - 2024-09-09: Can we build static web pages with Meteor.js? https://www.youtube.com/watch?v=cr-Nm0YFb1w + - 2024-09-16: Revisiting Mantra application architecture for today's Meteor.js https://www.youtube.com/watch?v=YyzY7ySqBAg + - 2024-08-23: TWIM 052: Year of TWIM in review. Trying to of sometime have xet7 at TWIM show again. They recommended people to help xet7 when possible, xet7 is hitting some walls developing WeKan. https://www.youtube.com/watch?v=c5E3uZST4Vs + - 2024-08-20: + - Vazco interviewing Storyteller: How to approach building Open Source products? https://www.youtube.com/watch?v=j5BrTYcJDVc + - Meteor inteviewing Storyteller: Programmer, open source contributor, entrepreneur https://www.youtube.com/watch?v=dsp0_r8uJx8 + - Meteor Roles: + - 2024-07-33: Meteor Roles the full checkpoint https://www.youtube.com/watch?v=ow1i4UXdbbI + - 2024-08-12: Meteor Roles building up teams https://www.youtube.com/watch?v=ZAuSYKfV114 - 2024-07-15: WeKan Upgrades https://www.youtube.com/watch?v=Zjb3m9JsAD0 - 2024-07-08: Upgrading Meteor examples https://www.youtube.com/watch?v=jzWXxOe93t4 - Upcoming and past: https://www.youtube.com/@storytellercz/streams - React.js - WeKan uses Blaze and Jade, not React. + - 2024-09-25: + - Meteor 3 React Compiler: https://x.com/FilipeNevola/status/1838911432282583432 - 2024-08-02: - https://www.youtube.com/watch?v=NnT7AbVMnj4 - https://thenewstack.io/after-a-decade-of-react-is-frontend-a-post-react-world-now/ diff --git a/docs/DeveloperDocs/WeKan-Multiverse-Roadmap.md b/docs/DeveloperDocs/WeKan-Multiverse-Roadmap.md index ee774d38c..da4a15c13 100644 --- a/docs/DeveloperDocs/WeKan-Multiverse-Roadmap.md +++ b/docs/DeveloperDocs/WeKan-Multiverse-Roadmap.md @@ -1,3 +1,19 @@ +## What is not Cross-Platform + +- Requires CPU to support AVX + - Bun Javascript Engine https://bun.sh + - MongoDB 5.x and newer https://github.com/turnkeylinux/tracker/issues/1724#issuecomment-2351544191 +- Does not work at s390x + - V programming language https://github.com/vlang/v/issues/18737 + - Bun Javascript Engine https://github.com/oven-sh/bun/issues/2632 + - Deno Javascript Engine https://github.com/denoland/deno/issues/20212#issuecomment-1756663943 + - Lazarus IDE https://www.lazarus-ide.org + - FreePascal programming language https://www.freepascal.org + - TigerBeetle database https://github.com/tigerbeetle/tigerbeetle/issues/2241 +- GUI requires porting to other OS + - BBC Basic https://www.bbcbasic.net/wiki/doku.php?id=converting_20programs_20from_20risc_20os_20to_20windows + - Tcl/Tk GUI does works at most OS + ## Prototype Strategy - Try building many prototypes, see what works @@ -265,8 +281,11 @@ https://github.com/wekan/php/blob/main/page/allboardschar.php ### FreePascal -- Repo https://github.com/wekan/hx/tree/main/prototypes/code/webserver/works/freepascal-router -- Router and some webpage +- Repo https://github.com/wekan/wami + - Some static pages +- Previous: + - Repo https://github.com/wekan/hx/tree/main/prototypes/code/webserver/works/freepascal-router + - Router and some webpage - Works at many retro and modern OS, but not at s390x that FreePascal does not support yet https://wiki.freepascal.org/ZSeries ### FreeDOS and Bash diff --git a/docs/DragDrop/Drag-Drop.md b/docs/DragDrop/Drag-Drop.md index b0b65a8e7..4da4c6b5f 100644 --- a/docs/DragDrop/Drag-Drop.md +++ b/docs/DragDrop/Drag-Drop.md @@ -38,4 +38,9 @@ Reorder with drag drop: - Draggable objects - https://www.redblobgames.com/making-of/draggable/ - https://news.ycombinator.com/item?id=37703291 -- Fixed Drag at Ubuntu Touch Morph browser https://github.com/wekan/wekan/commit/af63259f091cb2ade84493a288ea37c53cd37321 \ No newline at end of file +- Fixed Drag at Ubuntu Touch Morph browser https://github.com/wekan/wekan/commit/af63259f091cb2ade84493a288ea37c53cd37321 + +## Touch UI ideas + +- https://blog.la-terminal.net/godot-on-ipad-summer-update/ +- https://news.ycombinator.com/item?id=41415077 \ No newline at end of file diff --git a/docs/Email/Troubleshooting-Mail.md b/docs/Email/Troubleshooting-Mail.md index a845436d8..27d1c0f61 100644 --- a/docs/Email/Troubleshooting-Mail.md +++ b/docs/Email/Troubleshooting-Mail.md @@ -141,6 +141,8 @@ sudo snap set wekan mail-from='Wekan Team Boards ' ``` ## Example: AWS SES +Related https://github.com/wekan/wekan/discussions/5518 + NOTE: At AWS SES settings, you don't need to convert special characters. 1) At AWS SES, add verified sender email address, verified domain, verified DKIM etc. diff --git a/docs/Features/Linked-Cards.md b/docs/Features/Linked-Cards.md new file mode 100644 index 000000000..40767613f --- /dev/null +++ b/docs/Features/Linked-Cards.md @@ -0,0 +1,11 @@ +Linked Card feature was added at https://github.com/wekan/wekan/pull/1592 + +With Linked Card feature, it's possible to create new board as dashboard, and link cards from other boards to current board, seeing realtimes changes from all those cards at dashboard. + +Search is for searching card, to be as linked card, I presume. + +There is also Linked Board, but I'm not sure is it useful. + +Related PRs at https://github.com/wekan/wekan/pulls?q=is%3Apr+is%3Aclosed+linked+card+ + +Related issue https://github.com/wekan/wekan/issues/5550 \ No newline at end of file diff --git a/docs/Login/SAML.md b/docs/Login/SAML.md index 55ddce08c..f6fe2a4d7 100644 --- a/docs/Login/SAML.md +++ b/docs/Login/SAML.md @@ -9,20 +9,24 @@ Sandstorm has SAML login, and old WeKan that will be updated someday: How SAML works: -- https://ssoready.com/blog/engineering/a-gentle-intro-to-saml/ +- https://ssoready.com +- https://github.com/ssoready/ssoready +- https://news.ycombinator.com/item?id=41110850 +- https://ssoready.com/blog/from-the-founders/an-unpopular-perspective-on-the-sso-tax/ +- https://news.ycombinator.com/item?id=41303844/blog/engineering/a-gentle-intro-to-saml/ - https://news.ycombinator.com/item?id=41036982 - https://www.sheshbabu.com/posts/visual-explanation-of-saml-authentication/ - https://news.ycombinator.com/item?id=41057814 +- https://github.com/ssoready/ssoready +- https://news.ycombinator.com/item?id=41110850 +- https://ssoready.com/blog/from-the-founders/an-unpopular-perspective-on-the-sso-tax/ +- https://news.ycombinator.com/item?id=41303844 Ruby on Rails OmniAuth, that has Shibboleth and SAML: - https://github.com/omniauth/omniauth/wiki/List-of-Strategies - https://github.com/omniauth/omniauth - -SAML at SSOReady: - -- https://github.com/ssoready/ssoready -- https://news.ycombinator.com/item?id=41110850 +- Recent SAML issue https://news.ycombinator.com/item?id=41586031 The SSO Wall of Shame: diff --git a/docs/Platforms/FOSS/Cloud/CloudFlare.md b/docs/Platforms/FOSS/Cloud/CloudFlare.md new file mode 100644 index 000000000..76f523fc5 --- /dev/null +++ b/docs/Platforms/FOSS/Cloud/CloudFlare.md @@ -0,0 +1,5 @@ +CNAME to CNAME does not work well. Last one should be A IPv4 (and AAAA IPv6). + +To get Let's Encrypt SSL/TLS cert for custom subdomain, for example with Caddy, you subdomain should have grey cloud icon. Not orange cloud icon CloudFlare proxy. Also turn off any SSL/TLS of CloudFlare. This is so that Let's Encrypt verifying servers can see hosting server actual IP address and validate cert. + +If needing wildcard SSL/TLS cert, for example for Sandstorm, create CloudFlare Origin Certificate, add it to Caddy or Nginx certs .pem file (private key above, other key below, at same textfile). Set CloudFlare SSL/TLS as Strict for using Origin Certificate. Set DNS to orange cloud icon proxy. Add DNS records for example.com , *.example.com , www.example.com . \ No newline at end of file diff --git a/docs/Platforms/FOSS/Docker/Docker.md b/docs/Platforms/FOSS/Docker/Docker.md index 5ca41dcb9..2cbf68987 100644 --- a/docs/Platforms/FOSS/Docker/Docker.md +++ b/docs/Platforms/FOSS/Docker/Docker.md @@ -283,4 +283,4 @@ sudo docker compose up -d --build * [Caddy Webserver Config](Caddy-Webserver-Config) * [Nginx Webserver Config](Nginx-Webserver-Config) -* [Apache Webserver Config](Apache) +* [Apache Webserver Config](Apache) \ No newline at end of file diff --git a/docs/Platforms/FOSS/Sandstorm/Sandstorm.md b/docs/Platforms/FOSS/Sandstorm/Sandstorm.md index efeed0273..b419d60a1 100644 --- a/docs/Platforms/FOSS/Sandstorm/Sandstorm.md +++ b/docs/Platforms/FOSS/Sandstorm/Sandstorm.md @@ -1,6 +1,54 @@ +# Sandstorm at Debian and Ubuntu + +### Sandstorm CloudFlare DNS settings + +Source: https://github.com/sandstorm-io/sandstorm/issues/3714#issuecomment-2366866243 + +For me, it works at CloudFlare DNS using TLS Strict checking and DNS setting clicking to orange cloud icon to make TLS proxy with Origin certificate, that is at /etc/caddy/certs/example.com.pem with above private key and below cert. + +DNS records: +``` +* A example.com ip-address +@ A example.com ip-address +``` +Caddyfile, proxy to KVM VM that is running Debian and Sandstorm: +``` +*.example.com example.com { + tls { + load /etc/caddy/certs + alpn http/1.1 + } + + reverse_proxy 123.123.123.123:80 +} +``` +At /opt/sandstorm/sandstorm.conf is domain, http port etc. + +Some related info at: + +https://github.com/wekan/wekan/wiki/Caddy-Webserver-Config + +I also had to wait that Origin certificate becomes active. + +But this worked for me only at CloudFlare. It did not work at FreeDNS of Namecheap. + +Also, I still need to write script to fix IP address if Dynamic DNS IP address changes, using CloudFlare API, because my cable modem does not have DDNS option for CloudFlare. + +Now that there is also a way to run Sandstorm at Ubuntu, it would be possible for me to move Sandstorm from KVM VM to run directly at host, without VM, and proxy from Caddy to localhost port of Sandstorm. + +https://groups.google.com/g/sandstorm-dev/c/4JFhr7B7QZU?pli=1 + +### Debian amd64 + +Installing Sandstorm works normally + +### Ubuntu 24.04 amd64 + +How to install Sandstorm: https://groups.google.com/g/sandstorm-dev/c/4JFhr7B7QZU + ## Sandstorm Website -[Sandstorm Website](https://sandstorm.io) +[Sandstorm Website](https://sandstorm.org) If you have any grains at Sandstorm's **Oasis montly paid service**, please move those to self-hosted, because [only **Oasis grain hosting** part is shutting down](https://sandstorm.io/news/2019-09-15-shutting-down-oasis) - [HN](https://news.ycombinator.com/item?id=20979428). This does not affect any other parts like self-hosting at sandcats.io, App Market, updates, etc. diff --git a/docs/Platforms/FOSS/s390x.md b/docs/Platforms/FOSS/s390x.md index bab1345e7..4041afbab 100644 --- a/docs/Platforms/FOSS/s390x.md +++ b/docs/Platforms/FOSS/s390x.md @@ -10,6 +10,9 @@ - https://arstechnica.com/information-technology/2023/07/the-ibm-mainframe-how-it-runs-and-why-it-survives/ - https://sdl-hercules-390.github.io/html/ - Big-endian s390x https://community.ibm.com/community/user/ibmz-and-linuxone/blogs/javier-perez1/2021/01/19/endianness-guidance-for-open-source-projects +- The Future of Big Iron: An Interview with IBM’s Christian Jacobi + - https://morethanmoore.substack.com/p/the-future-of-big-iron-telum-ii-and + - https://news.ycombinator.com/item?id=41846592 *** diff --git a/docs/Platforms/Propietary/Windows/Offline.md b/docs/Platforms/Propietary/Windows/Offline.md index a584a6946..39adb0d1a 100644 --- a/docs/Platforms/Propietary/Windows/Offline.md +++ b/docs/Platforms/Propietary/Windows/Offline.md @@ -8,19 +8,19 @@ This is without container (without Docker or Snap). Right click and download files 1-4: -1. [wekan-7.59-amd64-windows.zip](https://github.com/wekan/wekan/releases/download/v7.59/wekan-7.59-amd64-windows.zip) +1. [wekan-7.61-amd64-windows.zip](https://github.com/wekan/wekan/releases/download/v7.61/wekan-7.61-amd64-windows.zip) 2. [node.exe](https://nodejs.org/dist/latest-v14.x/win-x64/node.exe) -3. [mongodb-windows-x86_64-6.0.17-signed.msi](https://fastdl.mongodb.org/windows/mongodb-windows-x86_64-6.0.17-signed.msi) +3. [mongodb-windows-x86_64-6.0.18-signed.msi](https://fastdl.mongodb.org/windows/mongodb-windows-x86_64-6.0.18-signed.msi) 4. [start-wekan.bat](https://raw.githubusercontent.com/wekan/wekan/main/start-wekan.bat) 5. Copy files from steps 1-4 with USB stick or DVD to offline Windows computer -6. Double click `mongodb-windows-x86_64-6.0.17-signed.msi` . In installer, uncheck downloading MongoDB compass. +6. Double click `mongodb-windows-x86_64-6.0.18-signed.msi` . In installer, uncheck downloading MongoDB compass. -7. Unzip `wekan-7.59-amd64-windows.zip` , inside it is directory `bundle`, to it copy other files: +7. Unzip `wekan-7.61-amd64-windows.zip` , inside it is directory `bundle`, to it copy other files: ``` bundle (directory) diff --git a/docs/_Sidebar.md b/docs/_Sidebar.md index f6cb0ac4b..67c8a8431 100644 --- a/docs/_Sidebar.md +++ b/docs/_Sidebar.md @@ -128,6 +128,7 @@ # Features +* [Linked Cards](Linked-Cards) * [Drag Drop](https://github.com/wekan/wekan/wiki/Drag-Drop) on Mobile and Desktop * [Rclone: Store attachments to cloud storage like S3, MinIO, etc](Rclone) * [Python based features](Python)