Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

wiki vs haskell.org page content #59

Open
ketzacoatl opened this issue Jan 19, 2021 · 19 comments
Open

wiki vs haskell.org page content #59

ketzacoatl opened this issue Jan 19, 2021 · 19 comments

Comments

@ketzacoatl
Copy link
Contributor

Hello,

While reading about the haskell.org committee, I came across:

Which page is the authoritative? Should one just be a link to the other?
I find this type of duplication confusing at best and time-consuming at worst (if I want any confidence in my understanding of the material, I need to read both pages and compare the content).

I'd be happy to help with content updates, but not sure what updates would be welcome.

@ketzacoatl
Copy link
Contributor Author

Is this repo/project maintained?

@TikhonJelvis
Copy link
Member

Hey, sorry, missed your issue earlier!

I agree that the duplication is confusing. We're currently figuring out what to do with the Wiki in general, so this is something of a transitional state—although things have been moving slowly because everybody on the committee has been extra busy lately.

To me, it seems like the best solution would be to move all the relevant content about the Haskell.org Committee to the official Haskell.org website. In the past, we've gotten feedback that Wiki pages (even if they're edit protected) don't look official. Once we do that, we could replace the Wiki content itself with a link or redirect to the new page.

If you're interested in helping out, you could create a PR on this repo either adding details from the Wiki directly to the existing committee page, or creating another more detailed page with Haskell.org Committee rules/history/etc—whatever reads better. Otherwise I was thinking about creating a PR like that myself, but I won't have time to do that for a few weeks at least, so help is absolutely appreciated!

@ketzacoatl
Copy link
Contributor Author

@TikhonJelvis, that's understandable. Thank you for the guidance there, I'd be happy to at least take a look and see if I can get a PR started.

@TikhonJelvis
Copy link
Member

Awesome, thanks for looking into it!

ketzacoatl added a commit to ketzacoatl/www.haskell.org that referenced this issue Jan 26, 2021
As outlined in haskell-infra#59, there are two pages which describe the Haskell.org committee and it's roles, responsibilities, process, history, etc. One is here on haskell.org, the other is on the wiki at https://wiki.haskell.org/Haskell.org_committee. Both pages appear authoritative, but differ in their content. At the same time, the general consensus is to move content off the wiki (particularly the more "official" content such as this). We would then replace that wiki article with a link to the this page. This is a first attempt which is more of a "bulk import" (or "merge") of the existing content. Note that there are a few places where the differences in content on the haskell.org page and wiki article may seem to be in conflict (or where one does not go as far as the other). These discrepancies and conflicts should be reviewed and updated. Some of the wiki content is more verbose than that on this page, and may still deserve some word-smithing.

A rough list of changes:
* collected the full list of links at the bottom of the page
* move the list of "committee members" a little lower in the page, bumping contact info and responsibilities above
* Included (merged) process, history and responsibilities content (from the wiki) that was missing here on this page
@ketzacoatl
Copy link
Contributor Author

@TikhonJelvis it's not perfect, but it's a start. I'd like to see through updating the wiki article to point back at this page, so please review and LMK what additional updates would be best to make here. Thank you for helping to guide and move this along.

@ketzacoatl
Copy link
Contributor Author

That PR has been merged. Now we just need to update the wiki, to replace the existing content with a link to the authoritative page on haskell.org.

@TikhonJelvis
Copy link
Member

Yep. Heads up that it might take a few days—running into some technical difficulties on my end, and won't be able to deploy the site until they're fixed.

@TikhonJelvis
Copy link
Member

Finally resolved my technical issues and updated the site. Your changes should be live now. We should update the Wiki page too, but I don't think I have a Wiki account, but I'll ask around to find somebody who does.

@ketzacoatl
Copy link
Contributor Author

@TikhonJelvis I have a wiki account and can make those updates, however, when looking over haskell.org, I could not easily locate the updated page at https://www.haskell.org/haskell-org-committee/. Therefore, I would like to recommend we:

  • Update the wiki article to replace the existing content with a link to the authoritative page on haskell.org
  • Locate on haskell.org, where the links to the haskell-org-committee page will live, and add those links
  • Decide if we want to do something about the "if the haskell-org-committee page/url changes, the url in the wiki will be wrong" problem (maybe a comment in the markdown doc about the wiki page?)

@TikhonJelvis
Copy link
Member

If you have a Wiki account, please feel free to change the Haskell.org committee page to point to haskell.org/haskell-org-committee.

There are links to haskell.org/haskell-org-committee from the footer of haskell.org itself as well as the Community and Donations pages. There's also a link to this GitHub repo if people want to make contributions. It sounds like these links weren't clear when you were looking for them—how should we change that?

@ketzacoatl
Copy link
Contributor Author

@TikhonJelvis I tried to do as you suggest on the wiki, but it looks like there is another hurdle to overcome, some new person we need to hunt down and ask for permission to make this update:

image

There are links to haskell.org/haskell-org-committee from the footer of haskell.org itself as well as the Community and Donations pages.

I could be crazy, but I'm not seeing it:

image

@TikhonJelvis
Copy link
Member

Oh, it's the link where it says "Hosted and managed by Haskell.org, a 501(c)(3) non-profit."

Sounds like the wording is confusing. Would it make more sense if it said "...by the Haskell.org Committee" instead?

@TikhonJelvis
Copy link
Member

I'm not sure who would have permissions to edit the committee Wiki page; I expect it would be one of the Wiki admins. I'll try to track somebody down for that.

@gbaz
Copy link
Contributor

gbaz commented Mar 10, 2021

The wiki is not hosted by the haskell.org committee. The committee is just the governing board of the haskell.org nonprofit. The link text is accurate and changing it to say "committee" would be inaccurate.

@gbaz
Copy link
Contributor

gbaz commented Mar 10, 2021

If any current committee member wants rights on that page, let me know the account name and I can get them added.

@ketzacoatl
Copy link
Contributor Author

I don't have clearance, and it looks like we got stuck on this additional permission check by the wiki admins - @TikhonJelvis can you jump through these hoops with @gbaz so we can finish that first update?

ketzacoatl added a commit to ketzacoatl/www.haskell.org that referenced this issue Mar 26, 2021
…ll.org

This contributes to haskell-infra#59, moving authoritative content from the wiki to the primary haskell.org website.
After this is cleaned up and live, we can then update the wiki page to replace its content with a link back to this donations page on haskell.org.
@ketzacoatl
Copy link
Contributor Author

@TikhonJelvis I've started a new PR for a second page that has duplicate / questionable info, please see ☝️

Thank you for the feedback, and helping me to consolidate these pages.

@ketzacoatl
Copy link
Contributor Author

@gbaz has unlocked the Donations and Committee articles for updates (thank you!), so I have updated both of those pages:

#73 still needs updates and to be merged, but that will be easy.

Which pages should we do next? So far I've only focused on pages that I ran into in my own personal needs/research. Are there others that are easy/important/obvious enough to move without a big fuss?

ketzacoatl added a commit to ketzacoatl/www.haskell.org that referenced this issue May 6, 2021
…ll.org

This contributes to haskell-infra#59, moving authoritative content from the wiki to the primary haskell.org website.
After this is cleaned up and live, we can then update the wiki page to replace its content with a link back to this donations page on haskell.org.
@ketzacoatl
Copy link
Contributor Author

While I believe this is still an issue, should remain open until resolved, and should be resolved, I'm not seeing enough positive feedback or support in making these moves happen for me to continue doing it at this time. I may come back to move more pages in the future, if that were desired and I felt more invigorated, but at least at this time, I need to invest my time elsewhere. I am noting this here so a lack of attention is not considered being neglectful.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

3 participants