akashrajpurohit/howtoprofessionallysay

📖 A guide for your daily "professional" interactions

How to Professionally Say

A guide for your daily "professional" interactions

Bug report · Feature request

---

A simple static website for common phrases we might want to say to your colleagues but want to make it sound more professional.

The data for this is being collected from content created by @loewhaley on Instagram.

Read more about the project here

Disclaimer ❎

Hello reader. If you are coming from hackernews or reddit, firstly I want to thank you for sharing your thoughts and suggestions (if any). The intent of the project is not to make you respond in a passive aggressive tone but to show you some alternatives of how you might feel like saying sometimes over how you can reframe it a bit better (in some cases atleast)

I have gathered the data from a content creator on Instagram (@loewhaley) and yes of course the credits are mentioned everywhere about this.

Based on the responses there it seems like what I started as fun activity can be something more than I thought.

I'll be looking into the possibilities of improving the content to make it less satire and more appropriate for most of the people out there.

Since it's an open sourced project, you can share your feedbacks and idea improvements here.

At ending note, I would just like to say to anyone who feels this is really good and I'm going to use this word by word, please don't, take this as a grain of salt and not seriously (atleast at this point of time till I better structure the content) and anyone who feels negative about this, I'm sorry you feel that way but don't take this very seriously.

Technology Stack 💻

• Framework: Next.js
• Styling: TailwindCSS
• Deployment: Cloudflare Pages

Bugs or Requests 🐛

If you encounter any problems feel free to open an issue. If you feel the project is missing a feature, please raise a ticket on GitHub and I'll look into it. Pull request are also welcome.

Contributions 🤝

Please check the guide to learn more about contributing to this project

Credits 🙏

• @loewhaley and her work bestie
• Icons from flaticon and feathericons

Where to find me? 👦🏽

howtoprofessionallysay's Issues

Sync state between reloads for flow of data

Is your feature request related to a problem? Please describe.
Maintain the state of the selection of flow of data between reloads

Describe the solution you'd like
Can use local storage to keep the state of what flow of data user have preferred to look at.

Describe alternatives you've considered
Since we are storing the state on local storage, it won't be synced across multiple devices/browsers. But since we are not using any authenticated resource, it seems to be fine to go ahead with the local storage approach for now.

Introduce progressive enhancement on top of static semantic HTML document structure

Is your feature request related to a problem? Please describe.
Expanding question is currently reliant on JavaScript. With JavaScript disabled, there is no way to read the answers. (Besides sifting through source code.)

Describe the solution you'd like
Page should be served as accessible static HTML document with both question and answers accessible straight away. Only the "filter" feature should be client-side progressive enhancement not present in the static payload. The "reveal" feature could be done either using native <details><summary>Question</summary>Answer</details>[...] HTML structure with no need of client-side scripting, or with static description list (<dl><div><dt>Question</dt><dd>Answer</dd></div>[...]</dl>) progressively enhanced to interactive button toggle ("accordion") structures similar to current one.

Describe alternatives you've considered
"Robust" alternative with true answer reveal without client-side JavaScript would require either server-side scripting, presumably stateful (what seems a bit over-engineered, but perhaps Vercel could do that in meaningful manner?), or CSS label&checkbox hack (what is not optimal from accessibility perspective and has similar issues to JavaScript-only approach).

Additional context
Must praise otherwise quite accessible approach; current version works well with keyboard. Haven't tested screen readers but seeing reasonable aria attributes gives hope it was thought-out. Inline SVGs should be hidden from the tree, though.

Poor wording

"As per my prediction, this outcome does not come as a surprise."

As a native English speaker, this sentence sounds very unnatural. It is a "dangling modifier" (or similar); it sounds like the prediction you made was that the outcome would not be a surprise. But in fact you're trying to say that you predicted the outcome.

Better alternatives include:

• "This outcome does not come as a surprise."
• "This outcome agrees with my earlier prediction."
• "Seeing as it agrees with my earlier prediction, this outcome is not a surprise."

Multi-language / translations

Is your feature request related to a problem? Please describe.
If you're not english you have to translate everything

Describe the solution you'd like
Multi-lang support

Describe alternatives you've considered
nothing

Additional context
no

How do you professionally say....

Finally you responded

or Took your time to respond

etc

Not an issue

Hi 👋🏻

I just wanted to thank you for doing this project. I am someone who is sorely lacking in tackles, and discovering a project like this will help me a lot in my daily life.

This is not an issue, just encouragement from me and thanks.

Thank you!

Fonts optimization

I recommend (for performance reasons) to optimize fonts and serve modern format.

I wrote a little bit on th subject here: https://pavelloz.com/blog/google-fonts-optimization/

Toggle to switch the flow of data representation

Is your feature request related to a problem? Please describe.
Right now the data is displayed in direction of "what you want to say" -> "what you could say", we can have an option to switch this direction

Describe the solution you'd like
An option to toggle between these two flows

Additional context
This was by far most requested feature I could see on hackernews and reddit, i.e being able to understand in simple terms when someone uses these jargon sentences to communicate with me.

API or NPM Package?

Is your feature request related to a problem? Please describe.
Hi, I’m currently looking for some ideas on what I could implement as a Raycast extension and I remembered this project. Would it be possible to (ideally) provide a simple JSON API or (worse but also appreciated) an NPM package with the raw data?

Describe the solution you'd like
Ideally, a simple JSON API (or json file hosted on a predictable URL) would be great

Describe alternatives you've considered
An NPM package that contains the JSON would also help, but it would mean that downstream projects need to always update it manually.

Additional context
N/A