Even more Ubersicht about discussion

[janl]

@boennemann this is fantastic feedback. Thank you so much for taking the time to write it all up after having the patience of going through all the mazes we put up for you :)

I know we have a documentation and organisation effort going on that should help address at least some of the issues you mention :)

For the rest, we’ll look for a solution as well.

Thanks again!

[lewiscowper]

I really like the idea of a single readme file, that sounds like the sort of thing that I can really sink my teeth into. Also it's something we can refer to throughout other docs, as a "for more info look here" kind of document, plus it's something that hood.ie could use for sure. Ideally (not sure about how possible this is), we could use the main readme as the docs in hood.ie, and get hood.ie to pull that file in direct from the repo.

[davidpfahler]

This issue is stuck in "that would be great" mode. I do think this is of greatest importance to hoodie (feel free to disagree; just my outsiders opinion). I, for example, have the biggest troubles finding where stuff is, what is latest and what is outdated, which docs and readmes to trust and which are just dreamcode, etc.

I think the problem here is that

1. it's hard to tell what the next actions are and
2. it's hard to find someone who could do it.

Open questions I can think of:

• Do we want one readme for using hoodie and one for developing it or both in one file?
• How does the website and docs.hood.ie play into this readme?
• Who has the proper overview over the project so they are able to write down and explain how it all works together? Is there even such a person who can still understand all the pieces?

@janl Maybe you can give us who are using hoodie and not in the core team some insight into what the roadmap is regarding these questions?

Thanks in advance. <3

[janl]

all this is currently being addressed in the website and documentation refactor ;)

On 17 Jul 2014, at 15:16 , David Pfahler [email protected] wrote:

This issue is stuck in "that would be great" mode. I do think this is of greatest importance to hoodie (feel free to disagree; just my outsiders opinion). I, for example, have the biggest troubles finding where stuff is, what is latest and what is outdated, which docs and readmes to trust and which are just dreamcode, etc.

I think the problem here is that

1. it's hard to tell what the next actions are and
2. it's hard to find someone who could do it.

Open questions I can think of:

• Do we want one readme for using hoodie and one for developing it or both in one file?
• How does the website and docs.hood.ie play into this readme?
• Who has the proper overview over the project so they are able to write down and explain how it all works together? Is there even such a person who can still understand all the pieces?
@janl Maybe you can give us who are using hoodie and not in the core team some insight into what the roadmap is regarding these questions?

Thanks in advance. <3

—
Reply to this email directly or view it on GitHub.

[davidpfahler]

@janl Is this on github? where can I find that?

[janl]

cc @ffffux

On 17 Jul 2014, at 16:11 , David Pfahler [email protected] wrote:

@janl Is this on github? where can I find that?

—
Reply to this email directly or view it on GitHub.

[lenareinhard]

@davidpfahler Hi, I'm the person with the overview over these parts of Hoodie.

We're completely aware there are currently many issues with the website, the docs, the general overview and displaying opportunities for contributors (aside from Ubersicht http://espy.github.io/ubersicht/#hoodiehq ). What we got now, is a team of 6 working on our website relaunch (some in full-time, some as part-time supporters and contributors) and a team of 7 working on the docs, plus people working on the roadmap etc. pp.

What we'll be doing in the new website:

• completely new structure
• far more content, all in one place (still generated e.g. from content on GitHub)
• redesign
• a new structure addressing people's skills and (probable) needs, and lead them to the content they need
• how to support Hoodie (with special, detailed "where and how to contribute" section)
• far, far more beyond that

What we're currently working on in addition:

• updated roadmap with detailed issues, owners and people who are assigned (current version is here #38, new version tba)
• documentation (see issues https://github.com/hoodiehq/documentation and repo https://github.com/hoodiehq/documentation) – the docs will also be deeply embedded in the new website
  We're aiming to display content on a central place, without creating maintenance overhead content-wise. Thus, I don't know yet if the solution to what has been adressed in this issue is a central Readme file, but will talk to the docs team about this.

Please note that the website relaunch project is not on GitHub. We're working mostly with designers (and designers / developers) and had asked them for their preferred collaboration platform and finally decided to not use GitHub as it's not really useful for design tasks, and also in terms of allowing them to focus.

I hear you and understand your concerns and the need to have all of this as fast and transparent as possible. We're trying to address all those issues you brought up as good as we can.

[gr2m]

@davidpfahler For the time being, I'm happy to chat to give answers to your questions first hand, just ping me on Twitter: twitter.com/gr2m. Thanks for taking the time to give us your outside perspective, that is very useful indeed!

[davidpfahler]

@ffffux @janl @g2m I'm convinced you are all doing your best and making great progress. No question about it. All I'm trying to do is to find - with an outsiders perspective - potential breakpoints for the user experience of using hoodie. It's great to see you put so much effort in docs and the website now. There is value in knowing that this is coming.

So we'll revisit this issue once docs and website are released and see what we can improve?

[janl]

@davidpfahler please just keep going and send anything you can find, it will make Hoodie a lot better. We are very grateful for your support! <3 :)

[lenareinhard]

@davidpfahler very much +1 on hearing your input, this is so helpful for us who have already dived too deep into the project :) In addition: If you have resources for that, I'd also love to hear your feedback on the new content structure (meaning: website + docs) in maybe four weeks or so, if this works for you, so we can improve the new setup. I'll also ask other people for feedback, but would love to have yours, too. Just think about it, maybe we can make this happen.

[davidpfahler]

@ffffux I'd be happy to give in-depth feedback on the website, docs etc. Just ping me when you think it makes sense.

[gr2m]

We addressed most of these points meanwhile :) I’m gonna close it as part of my issue triaging