From 46948dda2af14da5e45e3d8614195a3f4c98cbac Mon Sep 17 00:00:00 2001 From: Quarto GHA Workflow Runner Date: Thu, 5 Dec 2024 16:23:32 +0000 Subject: [PATCH] Built site for gh-pages --- .nojekyll | 2 +- im/github-organization-recs.html | 112 +++++++++++++++++++++++-------- search.json | 41 ++++++----- sitemap.xml | 36 +++++----- 4 files changed, 128 insertions(+), 63 deletions(-) diff --git a/.nojekyll b/.nojekyll index 1f3bd87..e3fcf9b 100644 --- a/.nojekyll +++ b/.nojekyll @@ -1 +1 @@ -80f3b4ee \ No newline at end of file +11813286 \ No newline at end of file diff --git a/im/github-organization-recs.html b/im/github-organization-recs.html index ea4e915..07b1225 100644 --- a/im/github-organization-recs.html +++ b/im/github-organization-recs.html @@ -206,11 +206,12 @@

On this page

@@ -239,46 +240,103 @@

GitHub Organization Recommendations

Rationale

-

GitHub Organizations are a great way of centralizing many individual GitHub repositories under a common umbrella. Access to these repositories is easily shared with organization members and limits to this access can be implemented smoothly as desired across groups of users simultaneously. Organizations also “own” repositories which lessens the risk of accidental deletion. Websites created by repositories owned by the same organization have a URL with a shared root which greatly simplifies navigation around the ecosystem of products produced by an organization.

-

The LTER Network recommends each LTER site create a GitHub organization for itself and then encourage site staff and visiting researchers to house their repositories there rather than in their own profiles. There are many benefits of GitHub Organizations (including those outlined above) and we hope that you share our excitement for this potential new direction!

-

The LTER Network has followed our own advice and has a GitHub Organization which you can see here!

+

GitHub Organizations are a great way of centralizing many individual GitHub repositories under a common umbrella. Access to these repositories is easily shared with organization members and limits to this access can be implemented smoothly across groups of users simultaneously. Organizations also “own” repositories which ensures that access to particular repositories cannot be lost with personnel changes.

+

The LTER Network recommends each LTER site maintain a GitHub organization for itself and then encourage site staff and visiting researchers to house their repositories there rather than in their own profiles. There are many benefits of GitHub Organizations (including those outlined above) and we hope that you share our excitement for this potential new direction!

+

The LTER Network Office has followed our own advice and made a GitHub Organization which you can see here!

+
+
+

Site GitHub “User” vs. “Organization”

+

It may seem simplest to simply make a new GitHub user account for your site (or use your existing personal user account if you have one) but creating a ‘true’ organization confers several benefits that make it worthwhile:

+ +

There are certainly other benefits you’ll likely experience after you take the plunge but hopefully this non-exhaustive list is persuasive as a reason to make the shift!

Naming Convention

-

We recommend adopting a common organization naming convention so that visitors to one organization can easily find the organization of another LTER site. Six sites currently have organizations and the general naming convention is to use the three letter site abbreviation in all caps followed by a hyphen and “LTER” (e.g., “MSP-LTER”).

-

Note that organization names can be changed as needed without breaking an individual user’s code but the link to GitHub-hosted websites/etc. will be changed if the organization name changes.

-
-
-

Organization Description & README

-

We also recommend adding a short description of your site to the organization page, so that visitors have a big-picture overview of your site. In addition, the organization page is a great place to link to your site’s main website, your Research Organization Registry (ROR), data catalog, or other platforms and build your online presence.

-

We also recommend that you create a README as a landing page for the Organization. To do this, create a public repository named “.github”. Add a “profile” folder and put “README.md” in that folder. The content of the README will then appear on your organization’s profile and will be the first thing visitors to the GitHub Organization will see.

+

We recommend adopting a common organization naming convention across sites so that visitors to one site’s organization can easily find the organization of another LTER site. There is some variance but most of the existing site organizations use the three letter site abbreviation in all caps followed by a hyphen and “LTER” (e.g., “MSP-LTER”). See below for a list of some of the site organizations.

+ +

Note that organization names can be changed later without breaking repository links but deployed website links will need to be updated. For example, changing “github.com/lter/test” to “github.com/lter/my-website” will let existing repository links automatically redirect to the new location but “lter.github.io/test” will throw a 404 error from GitHub (should be “lter.github.io/my-website”).

Administrators

-

Members of an organization can be designated “owners” and they will then have access to all possible settings for the organization (including inviting new members, changing the organization name, or deleting the organization among other functions). GitHub recommends adding more than one owner because if only a single person has that power, access to the organization settings is entirely dependent on that person.

+

Members of an organization can be designated as “owners” and they will then have access to all possible settings for the organization (including inviting new members and managing repository settings among other powers). GitHub recommends adding more than one owner because if only a single person has that power, access to the organization settings is entirely dependent on that person.

We recommend adding the following people as owners of a site organization:

Note that these people must all have a GitHub profile to be added as owners. Even if one of the prospective owners has no other need for a GitHub account, we feel it is worthwhile to have them create a GitHub profile for the sole purpose of allowing back-up access to the organization settings if that becomes necessary.

+
+

Organization Description & README

+

We also recommend adding a short description of your site to the organization page, so that visitors have a big-picture overview of your site. In addition, the organization page is a great place to link to your site’s main website, your Research Organization Registry (ROR), data catalog, or other platforms and build your online presence.

+

We also recommend that you create a README as a landing page for the Organization. To do this, create a public repository named “.github”. Add a “profile” folder and put “README.md” in that folder. The content of the README will then appear on your organization’s profile and will be the first thing visitors to the GitHub Organization will see. See the following as an example of this structure: github.com/lter/.github

+
-

Organization “Teams”

-

GitHub organizations control access to repositories in a slightly different way than repositories owned by individual users. In a user-owner repository, other profiles can be granted access and as each person is added, their level of access is decided by the profile that owns the repository. In an organization context however, access is controlled by Organization Teams. Instead of people being granted access to repositories, teams are granted access to repositories. Users are then added to team(s) as appropriate and their level of access is dictated by the access of the team. Note that only organization owners have the power to create teams or modify the level of access granted to existing teams.

-

We recommend creating the following teams:

+

Organization Teams

+

GitHub organizations handle access to particular repositories via teams. Normally, to share a repository you invite particular users to a given repository from the settings page of that repository. In an organization context, you do the following:

+
    +
  1. Create a team
    2. +
  2. Add all relevant organization members to that team +
      +
    • Note that they must be organization members
      • +
    3. +
  3. Add all relevant repositories to that team +
      +
    • When you do this you can choose the level of access all team members have to that repository
      • +
    4. +
+

This has a few distinct advantages relative to the non-organization method of sharing access.

+ -

You may also want to create additional teams for active research or lab groups that have many repositories where a consistent set of profiles will need access to all of those repositories.

-

As new repositories are added to the organization, an organization owner will need to add teams to those repositories (so that people in each team have the correct level of access to that repository).

+

Note that only organization owners have the power to create teams or modify the level of access granted to existing teams. If a given research group has two or more repositories in the organization we recommend creating a team for that group to streamline access going forward. Consider the teams in the LTER Network GitHub organization as an example for how you might structure your site’s organization.

-
-

Example Organization - BLE

-

The Beaufort Lagoon Ecosystem GitHub Organization is a phenomenal example of everything we just described above! Check out their organization for a nice example of how one site went about setting up an Organization for themselves.

+
+

Table of Contents Repository

+

Finally, we recommend creating a ‘table of contents’ repository when you create your site organization. It might seem excessive when you only have a handful of repositories but starting one early will make it easier to keep an eye on how repositories are organized within your organization (including repository naming conventions and use of GitHub topics)

+

The LTER Network organization index repository can be found here: github.com/lter/lter_github-index and is directly linked from our organization-level README to make it easier for visitors to find/use that index.

GitHub Organization vs. Other Platforms

diff --git a/search.json b/search.json index a077e22..c9ca2a1 100644 --- a/search.json +++ b/search.json @@ -235,49 +235,56 @@ "href": "im/github-organization-recs.html", "title": "GitHub Organization Recommendations", "section": "", - "text": "GitHub Organizations are a great way of centralizing many individual GitHub repositories under a common umbrella. Access to these repositories is easily shared with organization members and limits to this access can be implemented smoothly as desired across groups of users simultaneously. Organizations also “own” repositories which lessens the risk of accidental deletion. Websites created by repositories owned by the same organization have a URL with a shared root which greatly simplifies navigation around the ecosystem of products produced by an organization.\nThe LTER Network recommends each LTER site create a GitHub organization for itself and then encourage site staff and visiting researchers to house their repositories there rather than in their own profiles. There are many benefits of GitHub Organizations (including those outlined above) and we hope that you share our excitement for this potential new direction!\nThe LTER Network has followed our own advice and has a GitHub Organization which you can see here!" + "text": "GitHub Organizations are a great way of centralizing many individual GitHub repositories under a common umbrella. Access to these repositories is easily shared with organization members and limits to this access can be implemented smoothly across groups of users simultaneously. Organizations also “own” repositories which ensures that access to particular repositories cannot be lost with personnel changes.\nThe LTER Network recommends each LTER site maintain a GitHub organization for itself and then encourage site staff and visiting researchers to house their repositories there rather than in their own profiles. There are many benefits of GitHub Organizations (including those outlined above) and we hope that you share our excitement for this potential new direction!\nThe LTER Network Office has followed our own advice and made a GitHub Organization which you can see here!" }, { "objectID": "im/github-organization-recs.html#rationale", "href": "im/github-organization-recs.html#rationale", "title": "GitHub Organization Recommendations", "section": "", - "text": "GitHub Organizations are a great way of centralizing many individual GitHub repositories under a common umbrella. Access to these repositories is easily shared with organization members and limits to this access can be implemented smoothly as desired across groups of users simultaneously. Organizations also “own” repositories which lessens the risk of accidental deletion. Websites created by repositories owned by the same organization have a URL with a shared root which greatly simplifies navigation around the ecosystem of products produced by an organization.\nThe LTER Network recommends each LTER site create a GitHub organization for itself and then encourage site staff and visiting researchers to house their repositories there rather than in their own profiles. There are many benefits of GitHub Organizations (including those outlined above) and we hope that you share our excitement for this potential new direction!\nThe LTER Network has followed our own advice and has a GitHub Organization which you can see here!" + "text": "GitHub Organizations are a great way of centralizing many individual GitHub repositories under a common umbrella. Access to these repositories is easily shared with organization members and limits to this access can be implemented smoothly across groups of users simultaneously. Organizations also “own” repositories which ensures that access to particular repositories cannot be lost with personnel changes.\nThe LTER Network recommends each LTER site maintain a GitHub organization for itself and then encourage site staff and visiting researchers to house their repositories there rather than in their own profiles. There are many benefits of GitHub Organizations (including those outlined above) and we hope that you share our excitement for this potential new direction!\nThe LTER Network Office has followed our own advice and made a GitHub Organization which you can see here!" }, { - "objectID": "im/github-organization-recs.html#naming-convention", - "href": "im/github-organization-recs.html#naming-convention", + "objectID": "im/github-organization-recs.html#site-github-user-vs.-organization", + "href": "im/github-organization-recs.html#site-github-user-vs.-organization", "title": "GitHub Organization Recommendations", - "section": "Naming Convention", - "text": "Naming Convention\nWe recommend adopting a common organization naming convention so that visitors to one organization can easily find the organization of another LTER site. Six sites currently have organizations and the general naming convention is to use the three letter site abbreviation in all caps followed by a hyphen and “LTER” (e.g., “MSP-LTER”).\nNote that organization names can be changed as needed without breaking an individual user’s code but the link to GitHub-hosted websites/etc. will be changed if the organization name changes." + "section": "Site GitHub “User” vs. “Organization”", + "text": "Site GitHub “User” vs. “Organization”\nIt may seem simplest to simply make a new GitHub user account for your site (or use your existing personal user account if you have one) but creating a ‘true’ organization confers several benefits that make it worthwhile:\n\nOrganizations have better tools for granting edit access to groups of users\n\nThrough teams (more on this later)\n\nOrganization membership is displayed on user profiles\n\nSo finding the site-level repositories from a user affiliated with the site is straightforward\n\nCentralizing code activity related to your site makes summarizing that work easier\n\nE.g., during midterm reviews\n\nWebsites hosted in an organization have a URL with a shared root\n\nE.g., lter.github.io/ssecr, lter.github.io/scicomp, etc.\n\n\nThere are certainly other benefits you’ll likely experience after you take the plunge but hopefully this non-exhaustive list is persuasive as a reason to make the shift!" }, { - "objectID": "im/github-organization-recs.html#organization-description-readme", - "href": "im/github-organization-recs.html#organization-description-readme", + "objectID": "im/github-organization-recs.html#naming-convention", + "href": "im/github-organization-recs.html#naming-convention", "title": "GitHub Organization Recommendations", - "section": "Organization Description & README", - "text": "Organization Description & README\nWe also recommend adding a short description of your site to the organization page, so that visitors have a big-picture overview of your site. In addition, the organization page is a great place to link to your site’s main website, your Research Organization Registry (ROR), data catalog, or other platforms and build your online presence.\nWe also recommend that you create a README as a landing page for the Organization. To do this, create a public repository named “.github”. Add a “profile” folder and put “README.md” in that folder. The content of the README will then appear on your organization’s profile and will be the first thing visitors to the GitHub Organization will see." + "section": "Naming Convention", + "text": "Naming Convention\nWe recommend adopting a common organization naming convention across sites so that visitors to one site’s organization can easily find the organization of another LTER site. There is some variance but most of the existing site organizations use the three letter site abbreviation in all caps followed by a hyphen and “LTER” (e.g., “MSP-LTER”). See below for a list of some of the site organizations.\n\nArctic (ARC) GitHub: LTER-ARC\nBeaufort Lagoon Ecosystems (BLE) Github: BLE-LTER\nCentral Arizona-Phoenix (CAP) GitHub: CAPLTER & GitLab: gitlab.com/caplter\nGeorgia Coastal Ecosystems (GCE) GitHub: GCE-LTER\nHubbard Brook (HBR) GitHub: HBR-LTER\nJornada Basin (JRN) GitHub: jornada-im\nKellogg Biological Station (KBS) GitHub: KBS-LTER\nKonza Prairie (KNZ) GitHub: KNZLTER\nLuquillo (LUQ) GitHub: LUQ-LTER\nMinneapolis-St. Paul (MSP) GitHub: MSP-LTER\nNiwot Ridge (NWT) GitHub: NWTLTER\nNortheastern Shelf (NES) GitHub Wiki: WHOIGit/nes-lter-ims/wiki\nPalmer (PAL) GitHub: PAL-LTER\nPlum Island Ecosystems (PIE) GitHub: PIE-LTER\nVirginia Coast Reserve (VCR) GitHub: VCR-LTER\n\nNote that organization names can be changed later without breaking repository links but deployed website links will need to be updated. For example, changing “github.com/lter/test” to “github.com/lter/my-website” will let existing repository links automatically redirect to the new location but “lter.github.io/test” will throw a 404 error from GitHub (should be “lter.github.io/my-website”)." }, { "objectID": "im/github-organization-recs.html#administrators", "href": "im/github-organization-recs.html#administrators", "title": "GitHub Organization Recommendations", "section": "Administrators", - "text": "Administrators\nMembers of an organization can be designated “owners” and they will then have access to all possible settings for the organization (including inviting new members, changing the organization name, or deleting the organization among other functions). GitHub recommends adding more than one owner because if only a single person has that power, access to the organization settings is entirely dependent on that person.\nWe recommend adding the following people as owners of a site organization:\n\nSite Primary Investigator\nSite Information Manager\nAt least one representative of the LTER Network Office\n\nNote that these people must all have a GitHub profile to be added as owners. Even if one of the prospective owners has no other need for a GitHub account, we feel it is worthwhile to have them create a GitHub profile for the sole purpose of allowing back-up access to the organization settings if that becomes necessary." + "text": "Administrators\nMembers of an organization can be designated as “owners” and they will then have access to all possible settings for the organization (including inviting new members and managing repository settings among other powers). GitHub recommends adding more than one owner because if only a single person has that power, access to the organization settings is entirely dependent on that person.\nWe recommend adding the following people as owners of a site organization:\n\nSite Primary Investigator\nSite Information Manager (yourself!)\nAt least one representative of the LTER Network Office\n\nIdeally either Marty Downs (marty-downs) and/or Nick Lyon (njlyon0)\n\n\nNote that these people must all have a GitHub profile to be added as owners. Even if one of the prospective owners has no other need for a GitHub account, we feel it is worthwhile to have them create a GitHub profile for the sole purpose of allowing back-up access to the organization settings if that becomes necessary." + }, + { + "objectID": "im/github-organization-recs.html#organization-description-readme", + "href": "im/github-organization-recs.html#organization-description-readme", + "title": "GitHub Organization Recommendations", + "section": "Organization Description & README", + "text": "Organization Description & README\nWe also recommend adding a short description of your site to the organization page, so that visitors have a big-picture overview of your site. In addition, the organization page is a great place to link to your site’s main website, your Research Organization Registry (ROR), data catalog, or other platforms and build your online presence.\nWe also recommend that you create a README as a landing page for the Organization. To do this, create a public repository named “.github”. Add a “profile” folder and put “README.md” in that folder. The content of the README will then appear on your organization’s profile and will be the first thing visitors to the GitHub Organization will see. See the following as an example of this structure: github.com/lter/.github" }, { "objectID": "im/github-organization-recs.html#organization-teams", "href": "im/github-organization-recs.html#organization-teams", "title": "GitHub Organization Recommendations", - "section": "Organization “Teams”", - "text": "Organization “Teams”\nGitHub organizations control access to repositories in a slightly different way than repositories owned by individual users. In a user-owner repository, other profiles can be granted access and as each person is added, their level of access is decided by the profile that owns the repository. In an organization context however, access is controlled by Organization Teams. Instead of people being granted access to repositories, teams are granted access to repositories. Users are then added to team(s) as appropriate and their level of access is dictated by the access of the team. Note that only organization owners have the power to create teams or modify the level of access granted to existing teams.\nWe recommend creating the following teams:\n\n“Admin” team including everyone at the LTER site that should have admin-level access to all repositories (i.e., can change repository-level settings)\n“Maintain” team including all lead researchers who need access to non-destructive actions in repositories (i.e., most repository-level settings)\n“Write” team including everyone who has any need to write any amount of code (i.e., no settings access but able to add/change code in a repository)\n\nYou may also want to create additional teams for active research or lab groups that have many repositories where a consistent set of profiles will need access to all of those repositories.\nAs new repositories are added to the organization, an organization owner will need to add teams to those repositories (so that people in each team have the correct level of access to that repository)." + "section": "Organization Teams", + "text": "Organization Teams\nGitHub organizations handle access to particular repositories via teams. Normally, to share a repository you invite particular users to a given repository from the settings page of that repository. In an organization context, you do the following:\n\nCreate a team\nAdd all relevant organization members to that team\n\nNote that they must be organization members\n\nAdd all relevant repositories to that team\n\nWhen you do this you can choose the level of access all team members have to that repository\n\n\nThis has a few distinct advantages relative to the non-organization method of sharing access.\n\nUsers gain access to team repositories without needing to accept a time-sensitive invite\nWhen you make a new repository that falls under the purview of an existing team, it takes one action to empower all members of the team to access that repository\nYou can still add users to specific repositories in the way you normally would!\n\nSo no lost functionality by embracing teams\n\n\nNote that only organization owners have the power to create teams or modify the level of access granted to existing teams. If a given research group has two or more repositories in the organization we recommend creating a team for that group to streamline access going forward. Consider the teams in the LTER Network GitHub organization as an example for how you might structure your site’s organization." }, { - "objectID": "im/github-organization-recs.html#example-organization---ble", - "href": "im/github-organization-recs.html#example-organization---ble", + "objectID": "im/github-organization-recs.html#table-of-contents-repository", + "href": "im/github-organization-recs.html#table-of-contents-repository", "title": "GitHub Organization Recommendations", - "section": "Example Organization - BLE", - "text": "Example Organization - BLE\nThe Beaufort Lagoon Ecosystem GitHub Organization is a phenomenal example of everything we just described above! Check out their organization for a nice example of how one site went about setting up an Organization for themselves." + "section": "Table of Contents Repository", + "text": "Table of Contents Repository\nFinally, we recommend creating a ‘table of contents’ repository when you create your site organization. It might seem excessive when you only have a handful of repositories but starting one early will make it easier to keep an eye on how repositories are organized within your organization (including repository naming conventions and use of GitHub topics)\nThe LTER Network organization index repository can be found here: github.com/lter/lter_github-index and is directly linked from our organization-level README to make it easier for visitors to find/use that index." }, { "objectID": "im/github-organization-recs.html#github-organization-vs.-other-platforms", diff --git a/sitemap.xml b/sitemap.xml index a5e58a3..98be035 100644 --- a/sitemap.xml +++ b/sitemap.xml @@ -2,74 +2,74 @@ https://lter.github.io/docs-network/pi/home.html - 2024-12-05T15:29:46.948Z + 2024-12-05T16:23:11.427Z https://lter.github.io/docs-network/im/site-websites.html - 2024-12-05T15:29:46.948Z + 2024-12-05T16:23:11.423Z https://lter.github.io/docs-network/im/site-personnel.html - 2024-12-05T15:29:46.948Z + 2024-12-05T16:23:11.423Z https://lter.github.io/docs-network/im/new-to-lter.html - 2024-12-05T15:29:46.948Z + 2024-12-05T16:23:11.423Z https://lter.github.io/docs-network/im/home.html - 2024-12-05T15:29:46.948Z + 2024-12-05T16:23:11.423Z https://lter.github.io/docs-network/im/getting-help.html - 2024-12-05T15:29:46.944Z + 2024-12-05T16:23:11.423Z https://lter.github.io/docs-network/im/bibtex.html - 2024-12-05T15:29:46.944Z + 2024-12-05T16:23:11.423Z https://lter.github.io/docs-network/grad/home.html - 2024-12-05T15:29:46.944Z + 2024-12-05T16:23:11.423Z https://lter.github.io/docs-network/edu/home.html - 2024-12-05T15:29:46.944Z + 2024-12-05T16:23:11.423Z https://lter.github.io/docs-network/broaden_particip/home.html - 2024-12-05T15:29:46.944Z + 2024-12-05T16:23:11.423Z https://lter.github.io/docs-network/general/edits.html - 2024-12-05T15:29:46.944Z + 2024-12-05T16:23:11.423Z https://lter.github.io/docs-network/im/biblio-fields.html - 2024-12-05T15:29:46.944Z + 2024-12-05T16:23:11.423Z https://lter.github.io/docs-network/im/eml.html - 2024-12-05T15:29:46.944Z + 2024-12-05T16:23:11.423Z https://lter.github.io/docs-network/im/github-organization-recs.html - 2024-12-05T15:29:46.944Z + 2024-12-05T16:23:11.423Z https://lter.github.io/docs-network/im/new-to-im.html - 2024-12-05T15:29:46.948Z + 2024-12-05T16:23:11.423Z https://lter.github.io/docs-network/im/site-identifier.html - 2024-12-05T15:29:46.948Z + 2024-12-05T16:23:11.423Z https://lter.github.io/docs-network/im/site-publications.html - 2024-12-05T15:29:46.948Z + 2024-12-05T16:23:11.423Z https://lter.github.io/docs-network/index.html - 2024-12-05T15:29:46.948Z + 2024-12-05T16:23:11.427Z