Code Monkey home page Code Monkey logo

Comments (11)

mschnell1 avatar mschnell1 commented on June 21, 2024 2

@hecrj

In this case, documentation has not been a focus of ours yet, since the project is very experimental and the APIs have been changing wildly as we figure out the best way to approach GUIs in Rust.

I see.

For some time I have been involved in the "Lazarus" project (which is an open source version of the commercial "Delphi" software which features an extremely convenient way of doing GUI projects with a native compiled langauge). Hence I supposedly am spoiled in my attitude about GUI handling. After deciding to do all new projects in Rust I amoung other things evaluate the GUI crates and seemingly (regarding the great impression I got from the core of the Rust world) this is more bleeding edge than I expected. So thanks for baering with me.

Maybe come time, I might even be able to conrtibute something sensible :)

from iced.

mschnell1 avatar mschnell1 commented on June 21, 2024 1

@hecrj
Hmm.
I do "have a problem with the library", as I can't use part of it.
Of course I am aware that this is not a problem of the software, but of the documentation.
But why should that not be discussed on GitHub, where Documentation and examples are hosted / maintained together with the source code ? (Both is just text, and both is equally necessary for usage, after all. And of course both needs appropriate maintenance / user feedback for a crate to flourish. )
IMHO it would be best to have an appropriately "speaking" category "I have a problem with the library documentation" besides the "I have a problem with the library (code) ".
Many thanks for your attention (and making this crate happen) !

from iced.

fogarecious avatar fogarecious commented on June 21, 2024

I also had this problem.

I tried to implement a custom widget and return an overlay element in the widget's overlay method.
But nothing happened.

The code is roughly like this (where ... omits some code):

impl<...> Widget<...> for MyWidget {
    // ...
    fn overlay(...) -> ... {
        Some(Menu::new(...).overlay(...))
    }
}

from iced.

mschnell1 avatar mschnell1 commented on June 21, 2024

I did not yet understand the concept of "overlay". And I only understand a small gimps of the "theme" stuff.
Moreover it seems to be possible and/or necessary to use multiple renderers ?!?!?

from iced.

brianch avatar brianch commented on June 21, 2024

There's a ready to use context_menu widget in iced_aw: https://github.com/iced-rs/iced_aw/tree/main/examples/context_menu

The menu in iced_widget is the dropdown part of the picklist, that's why there's no example using it alone.

from iced.

mschnell1 avatar mschnell1 commented on June 21, 2024

THIS does look promising ....

from iced.

hecrj avatar hecrj commented on June 21, 2024

This isn't a bug. Please, read the available options when creating a new issue carefully next time:

image

Feel free to ask for help in our Discord server or our Discourse forum.

from iced.

hecrj avatar hecrj commented on June 21, 2024

I do "have a problem with the library", as I can't use part of it.
Of course I am aware that this is not a problem of the software, but of the documentation.

You are aware and decided to file a bug report anyways. A bit passive-aggresive, isn't it? Isn't this behavior suggesting that either you don't care or, even though you just arrived here, you think you know better than me how I should be managing my own project?

But why should that not be discussed on GitHub

Because the author of the project (the person that you are writing the bug report to, is giving you the software for free, and ultimately addresses everyone's feedback) explicitly and literally asks you to.

IMHO it would be best to have an appropriately "speaking" category "I have a problem with the library documentation" besides the "I have a problem with the library (code) ".

What would be "best" doesn't matter. What matters is how the maintainers of the software you use for free want you to interact with them. I don't want to receive "bug reports" about documentation on GitHub when there are clearly other channels set up to ask for help and discuss these topics.

Many thanks for your attention (and making this crate happen) !

You are welcome! I appreciate it.

from iced.

brianch avatar brianch commented on June 21, 2024

@mschnell1 As Héctor pointed out, you're welcome to ask questions and discuss things in Discourse or Discord, they exist exactly for this purpose, which is nice because that way github doesn't get too crowded with general questions, which would make the triage of actual bugs very difficult.

I do "have a problem with the library", as I can't use part of it.

Perhaps there's still some misunderstanding, as I mentioned, the 'menu' that appears in iced_widget is just part of the picklist widget, it's not something to be used by itself. For context menus there's the iced_aw widget.

from iced.

mschnell1 avatar mschnell1 commented on June 21, 2024

" For context menus there's the iced_aw widget."

Yep. Happily in this discussion I have been pointed to same and of course I will try to make use of same ASAP. I did a lot of research and have not been able to find the appropriate "entry point" before. Maybe over there is a better place to discuss the "menu's" documentation / example / findability issues.

Sorry, if I have been perceived as rude, stating that for me documentation is an integral part of any software. Maybe this is just me.

In fact I did quite a lot of (rather small) open source software projects (here on GitHub on the "ReaTeam" repository), and always try to do sufficient documentation, and improve the documentation (if I see a shortcoming or on request) together with the source code.

Thanks to all trying to improve the rust GUI world, which - as I seem to see - right now is one of the most "critical" areas of the fantastically evolving Rust world.

from iced.

hecrj avatar hecrj commented on June 21, 2024

@mschnell1 No worries! Every project works differently and has different priorities. Software or open-source doesn't ought to work in any particular way.

As Rich Hickey once wrote in "Open Source is Not About You":

The only people entitled to say how open source 'ought' to work are people who run projects, and the scope of their entitlement extends only to their own projects.

In this case, documentation has not been a focus of ours yet, since the project is very experimental and the APIs have been changing wildly as we figure out the best way to approach GUIs in Rust. But even if we just simply did not want to write any documentation, that would be fine as well!

from iced.

Related Issues (20)

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.