I found the Getting started page for D7, and had a go at it, but it seems like some things have changed between D7 and D8 ...

Comments

ressa created an issue. See original summary.

left’s picture

@kristiaanvandeneynde I would be happy to help with some basic documentation, involving the configuration for what is currently available via the GUI.

If this would be helpful, please let me know how best to proceed. I have screenshots and instructions, based on my initial adventures using this module.

*Edit - I just discovered I can add a page to the documentation section :)

Thanks,
Lisa

ressa’s picture

Thanks Lisa, I am looking forward to reading it :-)

left’s picture

I've started some basic docs here.

https://www.drupal.org/docs/8/modules/group/basic-configuration

Feel free to edit and amend as anyone sees fit.

When I was working with this module initially, I found some things hard to find, so at the very least, these might help show what is available.

Confirmation that elements exist can be enough to help a newbie along :)

ressa’s picture

I just went through your tutorial, and it is really great, thanks a lot for taking the time to write it!

I added a bit about how to set permissions. I also changed the image captions to italic, I hope it's all right.

ressa’s picture

Status: Active » Needs review
lias’s picture

Thank you for writing up this documentation. I'm hoping that you can document how to differentiate between group content nodes and starndard Drupal content types as I'm having a hard time seeing the difference.

This is my set up. I've installed both Group and Group Node (8.x-1.0-beta5+13-dev) on Drupal 8.3.2.

I'm using the default Article content type with Group. I've installed/enabled the Group node (Article) using this path:
/admin/group/types/manage/groupname/content

I then added a group specific field named DescriptionGrpField as Text(formatted, long) using the Manage fields tab:
/admin/group/content/manage/groupname-group_node-article/fields

When I go to create the Group Node as a member, I was under the impression that this field would show up on:
/group/3/content/create/group_node%3Aarticle

Instead the default Body field from the core Article content type displays, not the DescriptionGrpField I created for my group type. Why isn't the group field I created displaying? I am even using the Group Operations > Create Article link to add this group node.

Group members have permission to create the groupname-group_node-article, they are enabled under group type permissions.

When I login as a non-member, I do not see the group's content which means group access works but I can't seem to figure out the difference between group_node-article and article and why fields don't display as I expected?

Any guidance you could add to the document page explaining this would be extremely helpful and greatly appreciated.

EDIT: One more detail, group members do not have permission to add core Article content, their permissions are all set in the Group console.

ressa’s picture

I am not sure @lsabug ... but perhaps this issue should be dedicated to adding documentation for the Group module, and you could create a separate issue for your challenge, since it might be a bug?

I saw a video today by Michael Anello, where he outlines the structure of the Group module. Some things have changed since the making of the video, but perhaps there are clues there? https://www.youtube.com/watch?v=GkiCLJk5n0s

lias’s picture

Hi @ressa, thanks for replying. I didn't think of this as a bug, was more a request for additional documentation, just maybe went overboard describing what I was seeing as I used the Group module.

I will take a look at the video, I've seen many but would like to still request that the next documentation write up be on using Group Nodes in Groups and how they relate to core content types. I am used to OG in D7 which may be part of the problem :)

Perignon’s picture

I just started trying out the Group module for a project I am working on. As a maintainer of a lot of modules on D.O, this module is very poor in the documentation area - not even a README! It is not ready for a release with documentation this poor.

deaconblues’s picture

I work with Perignon and the best documentation that we've found is at the following link. It's a bit outdated but is better than anything else available.

https://youtu.be/GkiCLJk5n0s

brad.bulger’s picture

Videos are not documentation. They may be useful, but they're no substitute. I have been looking through everything linked to the module and having great difficulty understanding even how this module is meant to be used. Maybe this relates to changes from 7.x to 8.x.

An example of a basic scenario: I would like to create a group that has some users as members and some nodes as content. How? Where is that written up?

ressa’s picture

Status: Needs review » Reviewed & tested by the community

Since the documentation is very comprehensive now (see https://www.drupal.org/docs/contributed-modules/group) I think it's safe to mark this RTBC. Maybe @left can get credited for her great work writing documentation?