> > Ideally, I would like to easily find old information especially when we > organize events like Fosdem or to review past contributor summit notes. > any plans w.r.t. updating https://www.jenkins.io/events/fosdem/ then? :)
On Thu, May 6, 2021 at 6:08 PM Olblak <[email protected]> wrote: > I am -1 for recovering Wiki as it was. -0 if we are talking about creating > a new Wiki from scratch on Atlassian Cloud, just for Jenkins GitHub > organization members. No Jenkins LDAP would be needed there if we chose > such a way. > > > -1 for Atlassian Cloud. To me, it's still not an option unless we ask > contributors to create an Atlassian account. > > https://support.atlassian.com/security-and-access-policies/docs/configure-saml-single-sign-on-with-an-identity-provider/ > > I think that Google Docs are quite fine, and I am definitely responsible > for dozens of Google Docs we have in the community. > > > To me, they are throw away documentation. Ideally, I would like to easily > find old information especially when we organize events like Fosdem or to > review past contributor summit notes. > > > > On Thu, May 6, 2021, at 4:45 PM, Oleg Nenashev wrote: > > I am -1 for recovering Wiki as it was. -0 if we are talking about creating > a new Wiki from scratch on Atlassian Cloud, just for Jenkins GitHub > organization members. No Jenkins LDAP would be needed there if we chose > such a way. > > IMHO Wiki can be largely replaced by Documentation-as-Code in > repositories, hackmd, and, if needed, on GitHub Wiki pages.SIGs could move > the moist of the contents there. Same for the Governance meeting, we could > move to HackMd easily. Advanced forums like Discourse could also help to > store particular pieces of content one would put on Wiki > > I think that Google Docs are quite fine, and I am definitely responsible > for dozens of Google Docs we have in the community. Indeed it is nearly > impossible to find something due to many different accounts being used. > Maybe having a sponsored GSuite account or Switching to OwnCloud could be > an option if we want to centralize the location of the documents. > > > > > > On Thu, May 6, 2021 at 3:57 PM Tim Jacomb <[email protected]> wrote: > > Please no, wiki's suck for quality documentation. > > Anyone can put whatever rubbish they want there. > > On Thu, 6 May 2021 at 14:41, 'Olblak' via Jenkins Infrastructure < > [email protected]> wrote: > > > Hi Everybody, > > During the last Infrastructure meeting > <https://github.com/jenkins-infra/documentation/blob/main/meetings/2021-05-04.md>, > Daniel Beck came with an interesting question. > > Considering the proliferation of Google documents and other random tools > to take notes, > shouldn't we consider bringing back Confluence? > > While I am not convinced that a wiki is THE solution, I definitely share > his frustration. > I feel we did a major step backward in terms of knowledge management > across the Jenkins project. > > Nowadays, the default behavior is to create a Google document to take > notes during meetings or event organizations. > This approach is very easy for synchronous collaboration but it also has > bad side effects. It's difficult to find old documents unless you > bookmarked them. And, documents lifecycle are affected by the "new" google > storage policy or corporate google accounts. > > Historically, we used the wiki to take notes and write documentation. > https://wiki.jenkins.io/display/JENKINS > That central place was really convenient to share and find information > across community initiatives. > > That being said, I didn't forget the reasons to move away from Confluence, > and here are some of them: > > 1. Spammers, because of the nature of the Jenkins project we tend to > attract a lot of spammers. Then *someone* has to do some clean-up. > 2. Maintaining confluence is a major distraction that nobody wants to do. > 3. Confluence in the current state is very slow mainly due to point 2 and > due to unfinished infrastructure work. > > The two last elements could be solved by asking the Linux Foundation to > maintain Confluence. The same way they do for Jira > <https://issues.jenkins.io> > Also, it's worth keeping in mind that Atlassian is deprecating their > on-prem solution in 2024. > > Several weeks ago, I started an experiment on the infrastructure project > to use hackmd.io to allow synchronous collaboration on meeting notes. > During a meeting or a maintenance window, everybody can participate then > at the end of the meeting someone pushes the notes to a git repository like > https://github.com/jenkins-infra/documentation/#documentation > To me it combines two approaches, it's as easy as a Google document to > collect notes and then we can easily store them on a git repository > directly in Markdown. > Unfortunately, I am not convinced by the asynchronous collaboration > workflow. > > There is a demo here - https://youtu.be/1s2Y3aPXTOI?t=126 (Sorry for the > poor video) > > As I said it's an experiment, the purpose is to simplify synchronous > collaboration and then persist the content on a git repository that can > easily be browsed. > > I would be curious to know your feeling about all of this and if you have > other suggestions. > > Cheers > > > -- > You received this message because you are subscribed to the Google Groups > "Jenkins Infrastructure" group. > To unsubscribe from this group and stop receiving emails from it, send an > email to [email protected]. > To view this discussion on the web, visit > https://groups.google.com/d/msgid/jenkins-infra/7fc740e9-3cfd-4daf-bb0d-44b7a8564930%40www.fastmail.com > <https://groups.google.com/d/msgid/jenkins-infra/7fc740e9-3cfd-4daf-bb0d-44b7a8564930%40www.fastmail.com?utm_medium=email&utm_source=footer> > . > > > -- > You received this message because you are subscribed to the Google Groups > "Jenkins Infrastructure" group. > To unsubscribe from this group and stop receiving emails from it, send an > email to [email protected]. > To view this discussion on the web, visit > https://groups.google.com/d/msgid/jenkins-infra/CAH-3BidiAX87%2BDenOYkqw2ArtQCc6HRXpNZ-r4To5gh2vNC7aQ%40mail.gmail.com > <https://groups.google.com/d/msgid/jenkins-infra/CAH-3BidiAX87%2BDenOYkqw2ArtQCc6HRXpNZ-r4To5gh2vNC7aQ%40mail.gmail.com?utm_medium=email&utm_source=footer> > . > > > -- > You received this message because you are subscribed to the Google Groups > "Jenkins Developers" group. > To unsubscribe from this group and stop receiving emails from it, send an > email to [email protected]. > To view this discussion on the web visit > https://groups.google.com/d/msgid/jenkinsci-dev/CAPfivLCVo8UR63d%2Ba0A102heOhadNa4K470AvdT-Wqzx2Hf_CQ%40mail.gmail.com > <https://groups.google.com/d/msgid/jenkinsci-dev/CAPfivLCVo8UR63d%2Ba0A102heOhadNa4K470AvdT-Wqzx2Hf_CQ%40mail.gmail.com?utm_medium=email&utm_source=footer> > . > > > -- You received this message because you are subscribed to the Google Groups "Jenkins Developers" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To view this discussion on the web visit https://groups.google.com/d/msgid/jenkinsci-dev/CAPfivLAvFFzEa7r5fxGAkBG0ccWOXE26m0pe86eY37NWidGwwA%40mail.gmail.com.
