Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
Next revisionBoth sides next revision
technology [2022/10/13 14:57] – [GitHub] ntnsndrtechnology [2023/03/22 23:08] – [NextCloud] ntnsndr
Line 23: Line 23:
 ''gitlab.com/medlabboulder'' ''gitlab.com/medlabboulder''
  
-**What it is**: GitLab is an open-source code collaboration platform, similar to GitHub.+**What it is**: GitLab is an open-source code collaboration platform, similar to GitHub. It is self-hostable on Cloudron, but it is resource-intensive, so we currently use the commercial instance, which is currently free for us. In addition to code hosting, we use it for some Web projects, such as [[https://communityrule.info|CommunityRule]], which is deployed through GitLab using Jekyll.
  
-**How it works**: Create an account on GitLab.com, and Nathan can grant you access to relevant projects.+**How it works**: Create an account on GitLab.com, and Nathan can grant you access to relevant projects. [[https://docs.gitlab.com/ee/gitlab-basics/index.html|Here are some basic docs]] on how GitLab and git in general work.
  
 We are in the process of shifting over to a self-hosted Git platform, Gogs (''git.medlab.host''), but we have yet to replace some GitLab features we rely on (e.g., the Pages service). We are in the process of shifting over to a self-hosted Git platform, Gogs (''git.medlab.host''), but we have yet to replace some GitLab features we rely on (e.g., the Pages service).
-===== GitLab ===== 
- 
-''gitlab.com/medlabboulder'' 
- 
-**What it is**: GitLab is an open-source code collaboration platform, similar to GitHub. It is self-hostable on Cloudron, but it is resource-intensive, so we currently use the commercial instance, which is currently free for us. In addition to code hosting, we use it for some Web projects, such as [[https://communityrule.info|CommunityRule]], which is deployed through GitLab using Jekyll. 
- 
-**How it works**: Create an account on GitLab.com, and Nathan can grant you access to relevant projects. [[https://docs.gitlab.com/ee/gitlab-basics/index.html|Here are some basic docs]] on how GitLab and git in general work. 
  
 ===== Newsletter ===== ===== Newsletter =====
Line 45: Line 38:
  
 One downside of the self-hosted email system is that it is more likely to get emails caught in spam than using the Colorado.edu system. But our list is too large for using SYMPA, and the university newsletter system is clunky. One downside of the self-hosted email system is that it is more likely to get emails caught in spam than using the Colorado.edu system. But our list is too large for using SYMPA, and the university newsletter system is clunky.
-===== NextCloud =====+===== Nextcloud =====
  
 ''cloud.medlab.host'' ''cloud.medlab.host''
Line 51: Line 44:
 **What it is**: [[https://nextcloud.com|NextCloud]] is a FLOSS platform for file-hosting and collaboration that is heavily extensible through plugins. We host it on Cloudron and use it to manage all our internal files and documents. It is also integrated with Collabora, a collaborative document editor. **What it is**: [[https://nextcloud.com|NextCloud]] is a FLOSS platform for file-hosting and collaboration that is heavily extensible through plugins. We host it on Cloudron and use it to manage all our internal files and documents. It is also integrated with Collabora, a collaborative document editor.
  
-**How it works**: Any MEDLab research fellows should be able to access our filesystem with their accounts. It works much like Google Docs. You can edit Mircosoft and OpenDocument office file formats (.docx, .odt, .pptx, .xlsx, etc.) online using the Collabora editor, but this is a bit clunky and slow. It might be easier to download such files to your computer, edit locally, and then re-upload. A faster and simpler collaborative editing tool, though less powerful, is NextCloud's built-in Markdown editor. To use it, create a "New text document" using the "+" button at the top, and create a file that ends with .md (as is the default). This is a good way to keep notes in simple rich text, though it is not a fully featured word processor.+**How it works**: Any MEDLab research fellows should be able to access our filesystem with their accounts. It works much like Google Docs. You can edit Mircosoft and OpenDocument office file formats (.docx, .odt, .pptx, .xlsx, etc.) online using the Collabora editor, but this is a bit clunky and slow. It might be easier to download such files to your computer, edit locally, and then re-upload. A faster and simpler collaborative editing tool, though less powerful, is Nextcloud's built-in Markdown editor. To use it, create a "New text document" using the "+" button at the top, and create a file that ends with .md (as is the default). This is a good way to keep notes in simple rich text, though it is not a fully featured word processor.
  
 Please use discretion in sharing access to files and folders. All files are available to MEDLab team members, but it may not be appropriate to share them externally. Please ask Nathan if you are uncertain about what would be appropriate. Please use discretion in sharing access to files and folders. All files are available to MEDLab team members, but it may not be appropriate to share them externally. Please ask Nathan if you are uncertain about what would be appropriate.
  
-NextCloud plugins give us a variety of tools, which you can access through the menu bar at the top of the Web interface. These include:+Nextcloud plugins give us a variety of tools, which you can access through the menu bar at the top of the Web interface. These include:
  
   * Deck - A [[https://en.wikipedia.org/wiki/Kanban|kanban]]-style tool for managing workflows. We use this mainly to manage logistics around grant reporting, but you can create your own deck for a project you're working on if it would help you with task management.   * Deck - A [[https://en.wikipedia.org/wiki/Kanban|kanban]]-style tool for managing workflows. We use this mainly to manage logistics around grant reporting, but you can create your own deck for a project you're working on if it would help you with task management.
Line 62: Line 55:
   * Element - This is our chat. See information on Matrix below.   * Element - This is our chat. See information on Matrix below.
  
-You can access NextCloud through the Web interface or through mobile apps. Note that the NextCloud mobile app really only includes the Files tool, while the Web interface includes access to all the tools.+You can access Nextcloud through the Web interface or through mobile apps. Note that the Nextcloud mobile app really only includes the Files tool, while the Web interface includes access to all the tools.
  
 ===== Matrix ===== ===== Matrix =====
Line 70: Line 63:
 **What it is**: [[https://matrix.org|Matrix]] is a FLOSS communications protocol intended to be a highly secure backend for chat, email, social media, and other applications. It is still early-stage, but it a very promising project, and it has already been adopted by several European governments seeking to reduce their dependence on US-based software companies. Rather than relying on centralized companies, it enables both federated and peer-to-peer connections. Our own instance is currently not federated with the wider Matrix network, as we only use it internally, but we could add this functionality if we see fit. We use Element, which is the flagship Matrix client; Element used to be called "Riot," which is why that's in the URL on NextCloud. **What it is**: [[https://matrix.org|Matrix]] is a FLOSS communications protocol intended to be a highly secure backend for chat, email, social media, and other applications. It is still early-stage, but it a very promising project, and it has already been adopted by several European governments seeking to reduce their dependence on US-based software companies. Rather than relying on centralized companies, it enables both federated and peer-to-peer connections. Our own instance is currently not federated with the wider Matrix network, as we only use it internally, but we could add this functionality if we see fit. We use Element, which is the flagship Matrix client; Element used to be called "Riot," which is why that's in the URL on NextCloud.
  
-**How it works**: Access it through the Element client from within NextCloud, or using a Matrix-compatible mobile app (such as the one also called Element). The server is hosted on Cloudron at matrix.medlab.host (which you only need to know if you're logging in through a mobile client; the Web client already knows this). When first logging in, it will ask you to create a security key, which is a long series of characters. Keep that someplace safe. Hopefully you won't need to use it very often. Log in with the same credentials you use for NextCloud.+**How it works**: Access it through the Element client from within NextCloud, or using a Matrix-compatible mobile app (such as the one also called Element). The server is hosted on Cloudron at `matrix.medlab.host` (which you only need to know if you're logging in through a mobile client; the Web client already knows this). When first logging in, it will ask you to create a security key, which is a long series of characters. Keep that someplace safe. Hopefully you won't need to use it very often. Log in with the same credentials you use for Nextcloud. Be sure to join the MEDLab Space to access all our rooms.
  
-Element does not support threaded discussions, but you can reply to others' posts. Use lots of reaction emojis! If you want to send an email notification to everyone in the room, include ''@room'' in your message. You can also notify individuals with ''@[username]''.