From 2e749eb9881b62fc57236b235827a4bdbbd87ff8 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Tue, 21 Apr 2026 10:27:06 +0000 Subject: [PATCH 1/2] Add basic user manual Agent-Logs-Url: https://github.com/frappe/gameplan/sessions/86e73454-3748-4559-8db9-fbb4651f11c9 Co-authored-by: netchampfaris <9355208+netchampfaris@users.noreply.github.com> --- user_manual.md | 231 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 231 insertions(+) create mode 100644 user_manual.md diff --git a/user_manual.md b/user_manual.md new file mode 100644 index 00000000..62dcd75a --- /dev/null +++ b/user_manual.md @@ -0,0 +1,231 @@ +# Gameplan User Manual + +Welcome to **Gameplan** — a space for thoughtful team discussions, shared notes, and lightweight task tracking. + +This guide is written for **non-technical users** who want a simple introduction to the product. + +--- + +## What you can do in Gameplan + +With Gameplan, you can: + +- join or browse **spaces** +- start and follow **discussions** +- reply to teammates at your own pace +- create and review **pages** for shared notes +- track work with **tasks** +- find updates through **notifications**, **search**, and **people** profiles + +> **Screenshot placeholder:** Add a full-page screenshot of the Gameplan home screen here. + +--- + +## 1. Sign in + +1. Open the Gameplan link shared with you by your team. +2. Enter your login details. +3. After signing in, you will land on your main workspace. + +If you are signing in for the first time, you may be guided through a short setup flow. + +> **Screenshot placeholder:** Add a screenshot of the login screen here. + +--- + +## 2. Understand the main areas + +After signing in, you will usually see navigation for areas like: + +- **Home** – your main landing area +- **Discussions** – recent or active conversations +- **Tasks** – work items assigned to you or your team +- **Pages** – shared documents and notes +- **People** – teammate profiles +- **Search** – quick way to find discussions, pages, and more +- **Notifications** – updates that need your attention +- **Spaces** – organized areas for teams, projects, or topics + +Depending on how your team has set up Gameplan, some names or options may vary slightly. + +> **Screenshot placeholder:** Add a screenshot of the sidebar or top navigation here. + +--- + +## 3. Create or join a space + +A **space** is where conversations and work stay organized. Your team might create spaces for: + +- a department +- a project +- a client +- a recurring topic + +To create a space: + +1. Open **Spaces**. +2. Select **Add new** or the space creation option. +3. Enter a name. +4. Choose an icon if needed. +5. Invite teammates if that option is available. +6. Save or continue. + +If spaces are already set up for you, simply open one and start participating. + +> **Screenshot placeholder:** Add a screenshot of the new space screen here. + +--- + +## 4. Start a discussion + +Discussions are the core of Gameplan. + +To start one: + +1. Open the space where you want to post. +2. Go to **Discussions**. +3. Select **New Discussion** or a similar button. +4. Enter a clear title. +5. Add your message or details. +6. Publish the discussion. + +### Tips for better discussions + +- Use a clear subject line. +- Keep one topic per discussion. +- Add context so others can reply thoughtfully. +- Post in the most relevant space. + +> **Screenshot placeholder:** Add a screenshot of the new discussion composer here. + +--- + +## 5. Reply to a discussion + +To join a discussion: + +1. Open the discussion. +2. Read the original post and existing replies. +3. Write your response in the reply area. +4. Submit your comment. + +You can use replies to: + +- answer questions +- give updates +- share feedback +- continue a thread without interrupting others in real time + +> **Screenshot placeholder:** Add a screenshot of an open discussion with replies here. + +--- + +## 6. Use pages for shared notes + +**Pages** are useful for longer content such as: + +- meeting notes +- plans +- proposals +- reference material + +To use pages: + +1. Open **Pages**. +2. Create a new page or open an existing one. +3. Add or edit content. +4. Save your changes. + +Some pages may be private, while others may be shared with a team or space. + +> **Screenshot placeholder:** Add a screenshot of a page editor or page view here. + +--- + +## 7. Track work with tasks + +If your team uses tasks in Gameplan, you can: + +- review open tasks +- open task details +- check status and due information +- follow progress inside a space + +To work with tasks: + +1. Open **Tasks**. +2. Select a task to view more details. +3. Review the description, assignee, status, and related updates. + +> **Screenshot placeholder:** Add a screenshot of the tasks list or task detail page here. + +--- + +## 8. Use notifications and search + +### Notifications + +Open **Notifications** to catch up on: + +- new replies +- activity in discussions you follow +- other updates relevant to you + +### Search + +Use **Search** when you need to quickly find: + +- a discussion +- a page +- a person +- a keyword or topic + +> **Screenshot placeholder:** Add a screenshot of the notifications view here. +> +> **Screenshot placeholder:** Add a screenshot of the search screen here. + +--- + +## 9. View people and profiles + +The **People** area helps you learn who is in your workspace. + +Profiles may include: + +- name +- photo +- bio or introduction +- recent posts or replies +- bookmarks + +This is useful when you want to understand who is involved in a conversation or project. + +> **Screenshot placeholder:** Add a screenshot of a user profile here. + +--- + +## 10. Helpful habits for new users + +- Check **Notifications** regularly. +- Keep discussions focused and well titled. +- Use **Pages** for information that should stay easy to reference later. +- Use the correct **space** so others can find your content. +- Use **Search** before starting a duplicate discussion. + +--- + +## Quick glossary + +- **Space**: an organized area for a team, project, or topic +- **Discussion**: a conversation thread +- **Reply / Comment**: a response inside a discussion +- **Page**: a shared document or note +- **Task**: a work item to track progress + +--- + +## Final note + +If something looks different in your workspace, that is normal. Your team may have different permissions, spaces, or setup options enabled. + +You can now use this manual as a starting point and replace the screenshot placeholders with real images from your own Gameplan workspace. From 0e9be3c04a5a0399345e8b9667d476217522048b Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Wed, 22 Apr 2026 13:27:10 +0000 Subject: [PATCH 2/2] Rewrite user manual around async-first philosophy Agent-Logs-Url: https://github.com/frappe/gameplan/sessions/7a1fa380-328d-4fa1-b48a-b561d0593bb0 Co-authored-by: netchampfaris <9355208+netchampfaris@users.noreply.github.com> --- user_manual.md | 291 ++++++++++++++++++++++++++++++++----------------- 1 file changed, 191 insertions(+), 100 deletions(-) diff --git a/user_manual.md b/user_manual.md index 62dcd75a..9a855062 100644 --- a/user_manual.md +++ b/user_manual.md @@ -1,33 +1,52 @@ # Gameplan User Manual -Welcome to **Gameplan** — a space for thoughtful team discussions, shared notes, and lightweight task tracking. +Welcome to **Gameplan**. -This guide is written for **non-technical users** who want a simple introduction to the product. +Gameplan is built for teams that want calmer, clearer communication. Instead of expecting everyone to be online at the same time, it gives people space to think, write, and respond well. It is designed to support **async-first collaboration**, where important conversations stay organized and easy to revisit. + +This manual is for **non-technical users** who want to get started quickly. + +> **Screenshot placeholder:** Add a homepage or dashboard screenshot here. + +--- + +## What Gameplan is for + +Gameplan helps teams: + +- have thoughtful conversations without the pressure of instant replies +- keep discussions organized by team, project, or topic +- write longer updates, proposals, and notes in one place +- follow work through tasks and shared context +- reduce the mess and urgency that often comes with chat-based communication + +If your team is used to chat tools, the biggest mindset shift is simple: + +> **Gameplan is not built for constant interruption. It is built for better thinking, better writing, and better shared understanding.** --- -## What you can do in Gameplan +## How to get the most out of Gameplan -With Gameplan, you can: +Before you begin, it helps to use Gameplan with the right habits: -- join or browse **spaces** -- start and follow **discussions** -- reply to teammates at your own pace -- create and review **pages** for shared notes -- track work with **tasks** -- find updates through **notifications**, **search**, and **people** profiles +- Write clearly so others can respond without needing extra back-and-forth. +- Use meaningful titles so discussions are easy to scan later. +- Post in the right space so the right people can find the context. +- Treat discussions like shared team knowledge, not temporary chat messages. +- Check in regularly, but do not feel pressure to respond instantly. -> **Screenshot placeholder:** Add a full-page screenshot of the Gameplan home screen here. +> **Screenshot placeholder:** Add a screenshot of the main navigation or workspace layout here. --- -## 1. Sign in +## 1. Sign in and enter your workspace -1. Open the Gameplan link shared with you by your team. -2. Enter your login details. -3. After signing in, you will land on your main workspace. +1. Open the Gameplan link shared by your team. +2. Sign in with your account. +3. You will arrive in your main workspace. -If you are signing in for the first time, you may be guided through a short setup flow. +If this is your first time using Gameplan, you may be guided through a short setup experience. > **Screenshot placeholder:** Add a screenshot of the login screen here. @@ -35,182 +54,252 @@ If you are signing in for the first time, you may be guided through a short setu ## 2. Understand the main areas -After signing in, you will usually see navigation for areas like: +Your workspace may include some or all of these sections: -- **Home** – your main landing area -- **Discussions** – recent or active conversations -- **Tasks** – work items assigned to you or your team -- **Pages** – shared documents and notes -- **People** – teammate profiles -- **Search** – quick way to find discussions, pages, and more -- **Notifications** – updates that need your attention +- **Home** – your starting point +- **Discussions** – ongoing team conversations - **Spaces** – organized areas for teams, projects, or topics +- **Pages** – shared notes and longer-form writing +- **Tasks** – work items and follow-up actions +- **People** – teammate profiles +- **Search** – a fast way to find discussions, pages, and people +- **Notifications** – recent activity that matters to you -Depending on how your team has set up Gameplan, some names or options may vary slightly. +These areas help your team separate quick awareness from deeper conversation. -> **Screenshot placeholder:** Add a screenshot of the sidebar or top navigation here. +> **Screenshot placeholder:** Add a screenshot of the sidebar or main menu here. --- -## 3. Create or join a space +## 3. Use spaces to keep conversations organized + +A **space** is where related work and communication live together. -A **space** is where conversations and work stay organized. Your team might create spaces for: +Your team may create spaces for: - a department - a project - a client -- a recurring topic +- a recurring initiative +- a shared topic such as hiring, product, or operations -To create a space: +When you post in the right space, people can find the full context later without searching across many unrelated channels. + +To open a space: + +1. Go to **Spaces**. +2. Select the space you want. +3. Browse its discussions, pages, and tasks. + +If you are allowed to create a new space: 1. Open **Spaces**. -2. Select **Add new** or the space creation option. -3. Enter a name. -4. Choose an icon if needed. +2. Choose **Add new** or the space creation option. +3. Enter a clear name. +4. Add an icon if you want. 5. Invite teammates if that option is available. 6. Save or continue. -If spaces are already set up for you, simply open one and start participating. - -> **Screenshot placeholder:** Add a screenshot of the new space screen here. +> **Screenshot placeholder:** Add a screenshot of the spaces list here. +> +> **Screenshot placeholder:** Add a screenshot of the create space screen here. --- -## 4. Start a discussion +## 4. Start discussions that are easy to reply to -Discussions are the core of Gameplan. +Discussions are the heart of Gameplan. -To start one: +Use them for: -1. Open the space where you want to post. +- updates +- decisions +- questions +- proposals +- announcements +- team-wide context + +To start a discussion: + +1. Open the right **space**. 2. Go to **Discussions**. -3. Select **New Discussion** or a similar button. -4. Enter a clear title. -5. Add your message or details. -6. Publish the discussion. +3. Select **New Discussion**. +4. Write a clear title. +5. Add your message. +6. Publish it. + +### A good discussion usually includes -### Tips for better discussions +- a title that explains the topic +- enough background for someone to reply later +- a clear question, proposal, or update +- any next step you want from readers -- Use a clear subject line. -- Keep one topic per discussion. -- Add context so others can reply thoughtfully. -- Post in the most relevant space. +Because Gameplan is built for thoughtful communication, it is worth taking an extra minute to write a discussion well. > **Screenshot placeholder:** Add a screenshot of the new discussion composer here. --- -## 5. Reply to a discussion +## 5. Reply thoughtfully instead of rushing -To join a discussion: +To reply to a discussion: 1. Open the discussion. 2. Read the original post and existing replies. 3. Write your response in the reply area. 4. Submit your comment. -You can use replies to: +Good replies help the whole team, not just the original author. When possible: -- answer questions -- give updates -- share feedback -- continue a thread without interrupting others in real time +- answer clearly +- add useful context +- keep replies on topic +- build on previous comments instead of repeating them -> **Screenshot placeholder:** Add a screenshot of an open discussion with replies here. +Since discussions stay visible over time, your reply may help future readers understand the decision or outcome. + +> **Screenshot placeholder:** Add a screenshot of a discussion with replies here. --- -## 6. Use pages for shared notes +## 6. Use pages for longer, lasting information + +**Pages** are best for content that should stay useful over time. -**Pages** are useful for longer content such as: +You can use pages for: - meeting notes -- plans +- project plans - proposals -- reference material +- team guides +- reference documents -To use pages: +Think of discussions as conversations and pages as longer-form knowledge. + +To work with pages: 1. Open **Pages**. 2. Create a new page or open an existing one. -3. Add or edit content. +3. Add or edit the content. 4. Save your changes. -Some pages may be private, while others may be shared with a team or space. +Some pages may be private. Others may be shared with a space or team. -> **Screenshot placeholder:** Add a screenshot of a page editor or page view here. +> **Screenshot placeholder:** Add a screenshot of a page editor here. --- -## 7. Track work with tasks +## 7. Track follow-up work with tasks + +If your team uses tasks in Gameplan, tasks help turn conversation into action. -If your team uses tasks in Gameplan, you can: +You may use tasks to: -- review open tasks -- open task details -- check status and due information -- follow progress inside a space +- assign work +- track status +- follow deadlines +- connect action items to the surrounding team context -To work with tasks: +To review tasks: 1. Open **Tasks**. -2. Select a task to view more details. -3. Review the description, assignee, status, and related updates. +2. Select a task to view its details. +3. Check its title, status, assignee, and description. +4. Follow updates as work progresses. -> **Screenshot placeholder:** Add a screenshot of the tasks list or task detail page here. +> **Screenshot placeholder:** Add a screenshot of the task list here. +> +> **Screenshot placeholder:** Add a screenshot of a task detail page here. --- -## 8. Use notifications and search +## 8. Use notifications to catch up calmly -### Notifications +**Notifications** help you see what needs your attention without forcing you into constant live chat. -Open **Notifications** to catch up on: +Open **Notifications** to catch up on things like: - new replies -- activity in discussions you follow -- other updates relevant to you +- updates in discussions you follow +- activity related to your work -### Search +This makes it easier to review important updates in batches, when you are ready. + +> **Screenshot placeholder:** Add a screenshot of the notifications page here. + +--- -Use **Search** when you need to quickly find: +## 9. Use search to find knowledge quickly + +As your team uses Gameplan more, discussions and pages become a valuable record of decisions and thinking. + +Use **Search** to find: - a discussion - a page +- a task - a person - a keyword or topic -> **Screenshot placeholder:** Add a screenshot of the notifications view here. -> +Before starting a new discussion, it is often worth searching first. Your team may already have the answer, background, or earlier decision documented. + > **Screenshot placeholder:** Add a screenshot of the search screen here. --- -## 9. View people and profiles +## 10. Get to know the people behind the work -The **People** area helps you learn who is in your workspace. +The **People** section helps you understand who is part of the workspace. Profiles may include: - name - photo -- bio or introduction -- recent posts or replies +- short bio +- posts and replies - bookmarks -This is useful when you want to understand who is involved in a conversation or project. +This is useful when you are working with teammates across time zones or across different teams. + +> **Screenshot placeholder:** Add a screenshot of a person profile here. -> **Screenshot placeholder:** Add a screenshot of a user profile here. +--- + +## A simple daily rhythm for using Gameplan + +Many teams get the best value from Gameplan when they use it like this: + +### At the start of the day + +- check notifications +- review important discussions +- look at tasks that need attention + +### During the day + +- post updates in the correct space +- reply when you have useful input +- write pages when information needs to last + +### At the end of the day + +- leave clear progress updates +- capture decisions in discussions or pages +- make it easy for others to continue asynchronously + +This rhythm helps your team stay aligned without requiring everyone to be online together. --- -## 10. Helpful habits for new users +## Best practices for healthy async communication -- Check **Notifications** regularly. -- Keep discussions focused and well titled. -- Use **Pages** for information that should stay easy to reference later. -- Use the correct **space** so others can find your content. -- Use **Search** before starting a duplicate discussion. +- Prefer clarity over speed. +- Put one main topic in each discussion. +- Write with future readers in mind. +- Use pages for content that should stay easy to reference. +- Use tasks when something needs ownership or follow-up. +- Keep information in the right space so it stays discoverable. --- @@ -219,13 +308,15 @@ This is useful when you want to understand who is involved in a conversation or - **Space**: an organized area for a team, project, or topic - **Discussion**: a conversation thread - **Reply / Comment**: a response inside a discussion -- **Page**: a shared document or note -- **Task**: a work item to track progress +- **Page**: a longer shared document or note +- **Task**: a work item used for follow-up and ownership --- ## Final note -If something looks different in your workspace, that is normal. Your team may have different permissions, spaces, or setup options enabled. +Every team will use Gameplan a little differently, but the core idea stays the same: + +**make communication calmer, more thoughtful, and easier to return to later.** -You can now use this manual as a starting point and replace the screenshot placeholders with real images from your own Gameplan workspace. +You can now replace the screenshot placeholders in this manual with images from your own Gameplan workspace.