GitHub repo and GitHub ORGS repo

[talmurshidi]

There is a problem with home links if the forked repo is ORGS.
The links in rendered README are different.
Examples:

• Lap Brussels
• Lap Antwerp class 21

You can notice that Study Board and deliverables are deafferents.
I solved it in Antwerp Class 20 and 21 by changing the URL.

• admin/scripts/top.js

- [Study Board](https://github.com/orgs/${env.user}/projects/${modules.board})

• admin/scripts/leaners.js
• You can notice classURL variable.

export const learner = (
  { modules = {}, env = {}, org = {} },
  { name = '', user = '', homePage = '' },
) => {
  const classURL = `https://github.com/orgs/${env.user}`;
  const repoURL = `https://github.com/${env.user}/${env.repo}`;

  // const repoURL = `https://github.com/${env.user}/${env.repo}`;

  // --- scoped utilities for generating links ---

  const projectSearch = (label = '', linkText = label, role = 'assignee') =>
    `[${linkText}](${classURL}/projects/${modules.board}?filterQuery=${role}%3A${user}+label%3A${label})`;

  // const projectSearch = (label = '', linkText = label, role = 'assignee') =>
  // `[${linkText}](${repoURL}/projects/${modules.board}?card_filter_query=${role}%3A${user}+label%3A${label})`;

  const issuesSearch = (label = [], linkText = label, role = 'assignee') =>
    `[${linkText}](${repoURL}/issues/?q=${role}%3A${user}+${
      Array.isArray(label)
        ? label.map((l) => `label%3A${l}`).join('+')
        : `label%3A${label}`
    })`;

  const aList = (...rows) =>
    rows
      .filter((row) => row.length > 0)
      .map((row) => row.join(' \\| '))
      .join('<br>');

  // --- build the section ---

  const header = `<h3 id="${user}">${name}</h3>`;

  const avatar = `<img src="./${env.assetsPath.join(
    '/',
  )}/avatars/${user}.png" height="200px" width="200px" alt="${user} avatar" />`;

  const discussionLinks = org.forum
    ? []
    : [
        `[help wanted](${repoURL}/discussions/categories/help-wanted?discussions_q=author%3A${user}+category%3Ahelp-wanted+is:unanswered)`,
        `[questions](${repoURL}/discussions/categories/question?discussions_q=author%3A${user}+category%3AQ%26A+is:unanswered)`,
        `[all discussions](${repoURL}/discussions/categories/question?discussions_q=includes%3A${user})`,
      ];
  const selfLinks = [
    `[${user}](https://github.com/${user})`,
    `[home page](${homePage || `https://${user}.github.io`})`,
    `[bio](./student-bios/${user}.md)`,
  ];
  const classLinks = [
    issuesSearch('check-in', 'check-ins'),
    projectSearch('deliverable', 'deliverables'),
    // issuesSearch('roll-call', 'roll-calls', 'commenter'),
    issuesSearch(['retro', 'check-in'], 'retros'),
  ];
  const issuesLinks = [
    `[opened](${repoURL}/issues?q=author%3A${user})`,
    `[assigned](${repoURL}/issues?q=assignee%3A${user})`,
    `[commented](${repoURL}/issues?q=commenter%3A${user})`,
    `[mentioned](${repoURL}/issues?q=mentions%3A${user})`,
  ];

  const linksList = aList(selfLinks, discussionLinks, classLinks, issuesLinks);

  const activity = `![${user} github activity](https://ghchart.rshah.org/${user})`;

  const stats = `![${user} github stats](https://github-readme-stats.vercel.app/api?username=${user}&show_icons=true&theme=default&hide_title=true&hide_rank=true)`;

  return `

| ${avatar} | ${header}<br>${linksList} |
| --------- | ------------ |

<details>
<summary>${name}'s github stats</summary>
<br>

${activity}

${stats}

</details>
<hr style="width:60%;align:center">
`;
};

• admin/scripts/module.js
• You can notice _projectSearch _ variable.

export const module = (
  { env = {}, modules = {} },
  {
    name = '',
    url = '',
    weeks = null,
    milestone = 0,
    description = '',
    gitpod = modules.gitpod,
    state = '',
  },
) => {
  // --- scoped utilities for generating links ---

  const urlSafeName = `"${encodeURIComponent(name)}"`;

  // New HYF ORG link
  const projectSearch = (label = '', linkText = label) =>
    `[${linkText}](https://github.com/orgs/${env.user}/projects/${modules.board}?filterQuery=milestone%3A${urlSafeName}+label%3A${label})`;

  // Old HYF ORG link
  // const projectSearch = (label = '', linkText = label) =>
  // `[${linkText}](https://github.com/${env.user}/${env.repo}/projects/${modules.board}?card_filter_query=milestone%3A${urlSafeName}+label%3A${label})`;

  const labelize = (name = '') => `label%3A${name}`;

  const issuesSearch = (label = '', linkText = label) =>
    `[${linkText}](https://github.com/${env.user}/${
      env.repo
    }/issues/?q=milestone%3A${urlSafeName}+${
      typeof label === 'string'
        ? labelize(label)
        : label.map(labelize).join('+')
    })`;

  // --- build the section ---

  const formattedName = name
    .split('-')
    .map((word) => word[0].toUpperCase() + word.slice(1))
    .join(' ');

  let moduleSection = `### [${formattedName}](${url})`;

  if (typeof weeks === 'number') {
    moduleSection += `: ${weeks} week${weeks === 1 ? '' : 's'}`;
    moduleSection += state === 'closed' ? ` (closed)` : '';
  }

  moduleSection += '\n\n>';

  moduleSection += issuesSearch('check-in', 'check-ins') + ' | ';

  moduleSection += projectSearch('deliverable', 'deliverables board') + ' | ';

  // moduleSection += issuesSearch('roll-call', 'roll-calls') + ' | ';

  moduleSection += issuesSearch(['retro', 'check-in'], 'retros') + ' || ';

  moduleSection += `[milestone](https://github.com/${env.user}/${env.repo}/milestone/${milestone})`;

  if (gitpod) {
    moduleSection += ` || [gitpod](https://gitpod.io/#${url}) `;
  }

  if (description) {
    moduleSection += ' \n\n ' + description;
  }

  return moduleSection + '\n\n';
};

Is there away to have one solution for both cases?
@colevandersWands

[colevandersWands]

Thanks for catching this @Tamer. If I understand the difference; in Class21 you are using an organization-level project board to track assignments, in Lab Brussels it was a repo-level project board.

Have you found the org-level board to be more practical? If not, I'd prefer to stick with a repo-level project board like in the Antwerp home. I think way is a more self-contained system, making it easier for someone to set up a class without needing to create a new org or needing to add an org-level project board if they don't want to fill that global space.

Thoughts?

[talmurshidi]

I agree with you, I prefer to update the documentation and add org-level board if someone wants to use it.

[colevandersWands]

To make sure we understand each other, we will:

• stick with repo-level boards for now
• update the docs to match
• save org-level boards as a possible future feature if someone wants it.

Do you want me to make these changes?

[talmurshidi]

Correct, I can update it asap.
Admin Docs I think ./Data is ./Admin
I will check what should be changed.