> > 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 <m...@olblak.com> 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 <timjaco...@gmail.com> 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 < > jenkins-in...@googlegroups.com> 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 jenkins-infra+unsubscr...@googlegroups.com. > 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 jenkins-infra+unsubscr...@googlegroups.com. > 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 jenkinsci-dev+unsubscr...@googlegroups.com. > 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 jenkinsci-dev+unsubscr...@googlegroups.com. To view this discussion on the web visit https://groups.google.com/d/msgid/jenkinsci-dev/CAPfivLAvFFzEa7r5fxGAkBG0ccWOXE26m0pe86eY37NWidGwwA%40mail.gmail.com.
