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

Replace Fork-Awesome #2929

Closed
mrdrogdrog opened this issue Oct 12, 2022 · 7 comments · Fixed by #3177 or #3331
Closed

Replace Fork-Awesome #2929

mrdrogdrog opened this issue Oct 12, 2022 · 7 comments · Fixed by #3177 or #3331
Labels
scope: frontend Only relevant for the frontend type: discussion Something needs to be planned/discussed
Milestone

Comments

@mrdrogdrog
Copy link
Member

mrdrogdrog commented Oct 12, 2022

Which part of the project should be enhanced?
Used Icons

Is your enhancement request related to a problem? Please describe.
The development of Fork Awesome seems to be dead again. There are many icons that haven't been released yet.
The last release is from Aug. 2021. The latest commit is from Dec. 2021

Describe the solution you'd like
I would like to deprecate the usage of Fork Awesome and use another open source icon font for the UI. Something like Material Icons or Bootstrap Icons. I especially don't wanna use FontAwesome because it's very FOSS-Unfriendly.

To keep compatibility with HD1 notes I wouldn't remove Fork Awesome with 2.0. I would rather suggest to deprecate the usage of Fork Awesome icons in markdown. Users could be informed about that by a new Linter that checks the code for icons like <i class="fa fa-arrow-right"></i> and offers a suitable replacement. We could add some kind of lib independent shortcode like :icon-arrow-right:.

In a later release we can remove Fork Awesome completly.

Describe alternatives you've considered
Keep Fork Awesome.

@mrdrogdrog mrdrogdrog added the type: discussion Something needs to be planned/discussed label Oct 12, 2022
@mrdrogdrog mrdrogdrog added this to the Release 2.0 milestone Oct 12, 2022
@DerMolly
Copy link
Member

DerMolly commented Oct 12, 2022

I think this is a very good idea. I'm unsure about the replacement icon font. I'll have a look at both and then edit this comment to let you know what I think is best…
Edit: I think I would prefer Bootstrap Icons. They seem like the better replacement since they cover more of what frok awesome covered…

@DerMolly DerMolly transferred this issue from hedgedoc/react-client Nov 22, 2022
@ErikMichelson ErikMichelson added the scope: frontend Only relevant for the frontend label Nov 22, 2022
@DerMolly
Copy link
Member

DerMolly commented Jan 14, 2023

We'll go with the following approach:

  1. In HD2 we'll ship both Bootstrap Icons and Fork Awesome. Deprecating Fork Awesome with 2.0.
  2. Replace Fork Awesome in the emoji picker.
  3. Implement a Linter that warn's the user about Fork Awesome and suggests replacing it with Bootstrap Icons.
  4. Remove Fork Awesome in a later 2.x release.

@davidmehren
Copy link
Member

davidmehren commented Jan 15, 2023

It makes no sense to me to ship two icon sets in 2.0, only to deprecate one of them shortly after.
We should use the major release to make the breaking change and be done with it.

@DerMolly
Copy link
Member

DerMolly commented Jan 15, 2023

The reason behind this is, that you would need to map one set of icons to the other, which is both time consuming and possible error prone or alternatively just break existing notes content, because <i class="fa fa-address-book-o" aria-hidden="true"></i> doesn't do anything anymore.

What we theoretically could do is just leave out the fork awesome and instead just have the linter tell you this is broken now, please change. As this feature is not really too much advertised in HedgeDoc and is mainly a artifact of us using fork awesome for the UI this maybe a decent solution.

@mrdrogdrog
Copy link
Member Author

mrdrogdrog commented Jan 15, 2023

It makes no sense to me to ship two icon sets in 2.0, only to deprecate one of them shortly after. We should use the major release to make the breaking change and be done with it.

We would deprecate Fork Awesome WITH 2.0 and then remove it completely later. We do that already with other stuff like the yt/Vimeo/pdf shortcodes. They're deprecated and the editor marks them as deprecated.

@DerMolly DerMolly linked a pull request Jan 15, 2023 that will close this issue
2 tasks
HedgeDoc 2.0 Frontend automation moved this from Backlog to Done Jan 15, 2023
@DerMolly DerMolly reopened this Jan 15, 2023
HedgeDoc 2.0 Frontend automation moved this from Done to In progress Jan 15, 2023
DerMolly added a commit that referenced this issue Jan 24, 2023
These icon set will replace fork awesome in the long run. For now both sets will coexist, but a linter will discourage usage of fork awesome.

See #2929

Signed-off-by: Philip Molares <philip.molares@udo.edu>
DerMolly added a commit that referenced this issue Feb 7, 2023
These icon set will replace fork awesome in the long run. For now both sets will coexist, but a linter will discourage usage of fork awesome.

See #2929

Signed-off-by: Philip Molares <philip.molares@udo.edu>
mrdrogdrog pushed a commit that referenced this issue Feb 9, 2023
These icon set will replace fork awesome in the long run. For now both sets will coexist, but a linter will discourage usage of fork awesome.

See #2929

Signed-off-by: Philip Molares <philip.molares@udo.edu>
@mrdrogdrog
Copy link
Member Author

mrdrogdrog commented Feb 13, 2023

Okay people, we need a decision now because I wanna close this issue.
Should we keep fork awesome or not?

  • We want to get rid of fork awesome because it seems to be unmaintained
  • Bootstrap icons support will be merged into the frontend soon
  • 2.0 is a good opportunity for that because it's a breaking change
  • A breaking change could confuse people because their documents would get broken
  • We have a linter in the editor that shows that FA is deprecated so nobody should be confused

Please comment or react now.
@davidmehren @InnayTool @ErikMichelson @DerMolly

mrdrogdrog pushed a commit that referenced this issue Feb 13, 2023
These icon set will replace fork awesome in the long run. For now both sets will coexist, but a linter will discourage usage of fork awesome.

See #2929

Signed-off-by: Philip Molares <philip.molares@udo.edu>
mrdrogdrog pushed a commit that referenced this issue Feb 13, 2023
These icon set will replace fork awesome in the long run. For now both sets will coexist, but a linter will discourage usage of fork awesome.

See #2929

Signed-off-by: Philip Molares <philip.molares@udo.edu>
Signed-off-by: Tilman Vatteroth <git@tilmanvatteroth.de>
@ErikMichelson
Copy link
Member

ErikMichelson commented Feb 13, 2023

In my opinion we should drop ForkAwesome icon support with version 2.0.

With HedgeDoc 2 we're already doing plenty of changes to the markdown renderer, we even distinguish between HFM1 and HFM2. Therefore it seems reasonable to not keep every old syntax and library around.
We could deprecate ForkAwesome icon syntax already with the next 1.x release with a changelog notice.
As we've got a linter message that is able to detect the old syntax, we can use it to show a message like "ForkAwesome icons are not supported in 2.0, please switch to bootstrap-icons" on occurrences of the ForkAwesome syntax.
Another point is that people might expect changes to their document more likely when upgrading from HedgeDoc 1 to HedgeDoc 2 than when they upgrade from HedgeDoc 2.0 to HedgeDoc 2.1. This also follows SemVer more closely.
Last, we avoid shipping another dependency that will be dropped in the future anyway.

mrdrogdrog pushed a commit that referenced this issue Feb 13, 2023
These icon set will replace fork awesome in the long run. For now both sets will coexist, but a linter will discourage usage of fork awesome.

See #2929

Signed-off-by: Philip Molares <philip.molares@udo.edu>
Signed-off-by: Tilman Vatteroth <git@tilmanvatteroth.de>
@ErikMichelson ErikMichelson linked a pull request Feb 13, 2023 that will close this issue
5 tasks
mrdrogdrog pushed a commit that referenced this issue Feb 13, 2023
These icon set will replace fork awesome in the long run. For now both sets will coexist, but a linter will discourage usage of fork awesome.

See #2929

Signed-off-by: Philip Molares <philip.molares@udo.edu>
Signed-off-by: Tilman Vatteroth <git@tilmanvatteroth.de>
mrdrogdrog pushed a commit that referenced this issue Feb 13, 2023
These icon set will replace fork awesome in the long run. For now both sets will coexist, but a linter will discourage usage of fork awesome.

See #2929

Signed-off-by: Philip Molares <philip.molares@udo.edu>
Signed-off-by: Tilman Vatteroth <git@tilmanvatteroth.de>
mrdrogdrog pushed a commit that referenced this issue Feb 13, 2023
These icon set will replace fork awesome in the long run. For now both sets will coexist, but a linter will discourage usage of fork awesome.

See #2929

Signed-off-by: Philip Molares <philip.molares@udo.edu>
Signed-off-by: Tilman Vatteroth <git@tilmanvatteroth.de>
mrdrogdrog pushed a commit that referenced this issue Feb 13, 2023
These icon set will replace fork awesome in the long run. For now both sets will coexist, but a linter will discourage usage of fork awesome.

See #2929

Signed-off-by: Philip Molares <philip.molares@udo.edu>
Signed-off-by: Tilman Vatteroth <git@tilmanvatteroth.de>
mrdrogdrog pushed a commit that referenced this issue Feb 13, 2023
These icon set will replace fork awesome in the long run. For now both sets will coexist, but a linter will discourage usage of fork awesome.

See #2929

Signed-off-by: Philip Molares <philip.molares@udo.edu>
Signed-off-by: Tilman Vatteroth <git@tilmanvatteroth.de>
mrdrogdrog pushed a commit that referenced this issue Feb 19, 2023
These icon set will replace fork awesome in the long run. For now both sets will coexist, but a linter will discourage usage of fork awesome.

See #2929

Signed-off-by: Philip Molares <philip.molares@udo.edu>
Signed-off-by: Tilman Vatteroth <git@tilmanvatteroth.de>
mrdrogdrog pushed a commit that referenced this issue Feb 19, 2023
These icon replace fork awesome. A linter informs the user about the deprecation.

See #2929

Signed-off-by: Philip Molares <philip.molares@udo.edu>
Signed-off-by: Tilman Vatteroth <git@tilmanvatteroth.de>
mrdrogdrog pushed a commit that referenced this issue Feb 19, 2023
These icon replace fork awesome. A linter informs the user about the deprecation.

See #2929

Signed-off-by: Philip Molares <philip.molares@udo.edu>
Signed-off-by: Tilman Vatteroth <git@tilmanvatteroth.de>
mrdrogdrog pushed a commit that referenced this issue Feb 19, 2023
These icon replace fork awesome. A linter informs the user about the deprecation.

See #2929

Signed-off-by: Philip Molares <philip.molares@udo.edu>
Signed-off-by: Tilman Vatteroth <git@tilmanvatteroth.de>
mrdrogdrog pushed a commit that referenced this issue Feb 19, 2023
These icon replace fork awesome. A linter informs the user about the deprecation.

See #2929

Signed-off-by: Philip Molares <philip.molares@udo.edu>
Signed-off-by: Tilman Vatteroth <git@tilmanvatteroth.de>
mrdrogdrog pushed a commit that referenced this issue Feb 19, 2023
These icon replace fork awesome. A linter informs the user about the deprecation.

See #2929

Signed-off-by: Philip Molares <philip.molares@udo.edu>
Signed-off-by: Tilman Vatteroth <git@tilmanvatteroth.de>
mrdrogdrog pushed a commit that referenced this issue Feb 21, 2023
These icon replace fork awesome. A linter informs the user about the deprecation.

See #2929

Signed-off-by: Philip Molares <philip.molares@udo.edu>
Signed-off-by: Tilman Vatteroth <git@tilmanvatteroth.de>
mrdrogdrog pushed a commit that referenced this issue Feb 21, 2023
These icon replace fork awesome. A linter informs the user about the deprecation.

See #2929

Signed-off-by: Philip Molares <philip.molares@udo.edu>
Signed-off-by: Tilman Vatteroth <git@tilmanvatteroth.de>
mrdrogdrog pushed a commit that referenced this issue Feb 21, 2023
These icon replace fork awesome. A linter informs the user about the deprecation.

See #2929

Signed-off-by: Philip Molares <philip.molares@udo.edu>
Signed-off-by: Tilman Vatteroth <git@tilmanvatteroth.de>
mrdrogdrog pushed a commit that referenced this issue Feb 22, 2023
These icon replace fork awesome. A linter informs the user about the deprecation.

See #2929

Signed-off-by: Philip Molares <philip.molares@udo.edu>
Signed-off-by: Tilman Vatteroth <git@tilmanvatteroth.de>
mrdrogdrog pushed a commit that referenced this issue Feb 22, 2023
These icon replace fork awesome. A linter informs the user about the deprecation.

See #2929

Signed-off-by: Philip Molares <philip.molares@udo.edu>
Signed-off-by: Tilman Vatteroth <git@tilmanvatteroth.de>
mrdrogdrog pushed a commit that referenced this issue Feb 22, 2023
These icon replace fork awesome. A linter informs the user about the deprecation.

See #2929

Signed-off-by: Philip Molares <philip.molares@udo.edu>
Signed-off-by: Tilman Vatteroth <git@tilmanvatteroth.de>
mrdrogdrog pushed a commit that referenced this issue Feb 22, 2023
These icon replace fork awesome. A linter informs the user about the deprecation.

See #2929

Signed-off-by: Philip Molares <philip.molares@udo.edu>
Signed-off-by: Tilman Vatteroth <git@tilmanvatteroth.de>
mrdrogdrog pushed a commit that referenced this issue Feb 22, 2023
These icon replace fork awesome. A linter informs the user about the deprecation.

See #2929

Signed-off-by: Philip Molares <philip.molares@udo.edu>
Signed-off-by: Tilman Vatteroth <git@tilmanvatteroth.de>
mrdrogdrog pushed a commit that referenced this issue Feb 22, 2023
These icon replace fork awesome. A linter informs the user about the deprecation.

See #2929

Signed-off-by: Philip Molares <philip.molares@udo.edu>
Signed-off-by: Tilman Vatteroth <git@tilmanvatteroth.de>
mrdrogdrog pushed a commit that referenced this issue Feb 22, 2023
These icon replace fork awesome. A linter informs the user about the deprecation.

See #2929

Signed-off-by: Philip Molares <philip.molares@udo.edu>
Signed-off-by: Tilman Vatteroth <git@tilmanvatteroth.de>
mrdrogdrog pushed a commit that referenced this issue Feb 22, 2023
These icon replace fork awesome. A linter informs the user about the deprecation.

See #2929

Signed-off-by: Philip Molares <philip.molares@udo.edu>
Signed-off-by: Tilman Vatteroth <git@tilmanvatteroth.de>
mrdrogdrog added a commit that referenced this issue Feb 23, 2023
These icon replace fork awesome. A linter informs the user about the deprecation.

See #2929

Co-authored-by: Philip Molares <philip.molares@udo.edu>
Co-authored-by: Tilman Vatteroth <git@tilmanvatteroth.de>
Signed-off-by: Philip Molares <philip.molares@udo.edu>
Signed-off-by: Tilman Vatteroth <git@tilmanvatteroth.de>
mrdrogdrog added a commit that referenced this issue Feb 23, 2023
These icon replace fork awesome. A linter informs the user about the deprecation.

See #2929

Co-authored-by: Philip Molares <philip.molares@udo.edu>
Co-authored-by: Tilman Vatteroth <git@tilmanvatteroth.de>
Signed-off-by: Philip Molares <philip.molares@udo.edu>
Signed-off-by: Tilman Vatteroth <git@tilmanvatteroth.de>
mrdrogdrog added a commit that referenced this issue Feb 23, 2023
These icon replace fork awesome. A linter informs the user about the deprecation.

See #2929

Co-authored-by: Philip Molares <philip.molares@udo.edu>
Co-authored-by: Tilman Vatteroth <git@tilmanvatteroth.de>
Signed-off-by: Philip Molares <philip.molares@udo.edu>
Signed-off-by: Tilman Vatteroth <git@tilmanvatteroth.de>
mrdrogdrog added a commit that referenced this issue Feb 24, 2023
These icon replace fork awesome. A linter informs the user about the deprecation.

See #2929

Co-authored-by: Philip Molares <philip.molares@udo.edu>
Co-authored-by: Tilman Vatteroth <git@tilmanvatteroth.de>
Signed-off-by: Philip Molares <philip.molares@udo.edu>
Signed-off-by: Tilman Vatteroth <git@tilmanvatteroth.de>
mrdrogdrog added a commit that referenced this issue Feb 24, 2023
These icon replace fork awesome. A linter informs the user about the deprecation.

See #2929

Co-authored-by: Philip Molares <philip.molares@udo.edu>
Co-authored-by: Tilman Vatteroth <git@tilmanvatteroth.de>
Signed-off-by: Philip Molares <philip.molares@udo.edu>
Signed-off-by: Tilman Vatteroth <git@tilmanvatteroth.de>
HedgeDoc 2.0 Frontend automation moved this from In progress to Done Feb 24, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
scope: frontend Only relevant for the frontend type: discussion Something needs to be planned/discussed
Projects
No open projects
Development

Successfully merging a pull request may close this issue.

4 participants