Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Comprehensive Update to the FriendFolio User Guide #133

Merged
merged 6 commits into from
Apr 15, 2024

Conversation

NewtonKoh
Copy link

Comprehensive Update to the FriendFolio User Guide

Overview

This pull request significantly enhances the FriendFolio User Guide to improve clarity, engagement, and user interaction. It aims to make the guide not only more informative but also more welcoming and easier to navigate.

Key Updates

  1. Introduction of 'What is FriendFolio?': Added a new section that provides a detailed description of the app's purpose and its main features, giving new users a solid understanding of what FriendFolio offers.
  2. Revamped 'Getting Started' Section: Updated the installation and setup instructions to be more concise and user-friendly, ensuring new users can get up and running without confusion.
  3. Expanded 'Command Overview': Enhanced this section with detailed explanations and examples for each command, including a comprehensive look at parameter prefixes and their usage.
  4. Friendlier Tone Throughout: Overhauled the guide’s tone to be more friendly and inviting, reflecting FriendFolio’s community-focused branding.
  5. Preview of Upcoming Features in 'Coming Soon in v2.0': Introduced a section previewing the exciting new features and improvements planned for the next version, generating anticipation and user interest.
  6. Improved Navigation Elements: Updated the navigation elements, including the integration of a more intuitive 'Return to Table of Contents' button to enhance user experience and accessibility.

Purpose

These updates are designed to make the User Guide not only a tool for learning but also a part of the enhanced user experience with FriendFolio, promoting better engagement and ensuring that users can fully leverage the app in their social and academic pursuits.

The improvements to the User Guide are expected to significantly enhance user satisfaction and help new users integrate FriendFolio into their daily routines more seamlessly.

This commit overhauls the FriendFolio User Guide to improve user
engagement and provide a clearer understanding of the app's features.
Key updates include:

1. Introduction of a new section, 'What is FriendFolio?', offering a
 comprehensive description of the app's purpose and key
 functionalities.
2. Revision of the 'Getting Started' section to streamline the
 installation and setup instructions for better user experience.
3. Expansion of the 'Command Overview' section with detailed
 explanations of each command, including parameter prefixes
 and usage examples.
4. Enhancement of the user guide's overall tone to be more friendly
 and inviting, aligning with FriendFolio's community-focused brand.
5. Addition of a 'Coming Soon in v2.0' section to preview upcoming
 features and improvements, building anticipation among users.

These changes aim to make the guide more intuitive and helpful,
ensuring users can fully leverage FriendFolio to enhance their
social and academic interactions.
@zhekaiii zhekaiii added the documentation Improvements or additions to documentation label Apr 15, 2024
@zhekaiii zhekaiii added this to the v1.4 milestone Apr 15, 2024
Copy link

@zhekaiii zhekaiii left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM!

- Ensure hyperlink is working for Command Overview
- Fix the warning icon info and add the caution icon
- Add bolding for attribute constraints
Copy link

@zhekaiii zhekaiii left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, might just need to make certain parts more concise! Great job!

of the guide that are most relevant to your needs!

- **Section Headers:** Each major section and sub-section of the guide is clearly labeled with descriptive headers.
As you scroll through the document or digital file, these headers will help you quickly identify the content of each

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

As you scroll through the document or digital file

Perhaps this can be reduced to "scroll through the user guide"?

allowing you to skim and find specific information efficiently

Do you think this part can be removed to make it more concise?

- **Return to Table of Contents Button:** At the bottom right of each section, you'll find a
[:arrow_heading_up:](#table-of-contents) icon. Clicking this takes you straight back to the
[Table of Contents](#table-of-contents), allowing for quick navigation without scrolling.
This handy feature saves time and streamlines your experience with the guide.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This handy feature saves time and streamlines your experience with the guide.

Do you think we can remove this line to make it more concise?

Comment on lines 378 to 384
Navigating FriendFolio is a breeze when you know how to talk to it! Each command you input needs little bits of data to
get the job done, and that's where parameter prefixes come into play. Think of them as quick shortcuts that help
FriendFolio understand exactly what details you're referring to.

Here’s a handy table to help you get acquainted with all the prefixes you’ll use to communicate with FriendFolio.
Whether you're adding a new contact or updating an existing one, these prefixes will make your interactions smooth
and effective.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe we can make this less wordy?

@NewtonKoh NewtonKoh merged commit f18bf64 into AY2324S2-CS2103T-T16-2:master Apr 15, 2024
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants