Code Monkey home page Code Monkey logo

discover-panel's Introduction

Discover Panel

Discover Panel is an extension that provides alternative UX for exploring APIs while coding. Its goal is to replace standard widget/popup based UI for API explorations - autocomplete and tooltips. It plugs into built-in VSCode APIs so it should work with any programming language - information displayed in the panel is taken from specific extensions you are using for given programming language.

docs/example.png

example.mov

Why?

In general I believe into providing developers with editor UX that's not disruptive or intrusive - I strongly believe into adding virtual enhancements to editor buffer. This trend is clearly present in my other projects like Ionide-F# where we have whole set of various "virtual" type information hints, or in GitHub Copilot where we present suggestions as "ghost" text.

The idea behind Discover Panel was created after one of my colleagues has sent me this image: docs/why.png

On the one hand, all information presented in those popups is useful in some scenarios - tooltips, and autocomplete have huge value for API discoverability. On the other hand, this is clearly intrusive - it basically covers all code the developer was working on in this given moment. As mentioned above, I'd rather see some kind of inline, virtual suggestion here (in style of GitHub Copilot suggestions). However, disabling autocomplete and tooltip widgets creates an issue for the API discoverability - you no longer can just see what functions are types are in given module/namespace or what some functions that you use in code does. And hopefully, that's exactly the problem that can be solved by Discover Panel.

Suggested VSCode settings

  • You can disable automatic showing of tooltip by setting editor.hover.enabled to false. Tooltip can still be triggered by running Show Hover command

  • You can disable automatic showing of autocomplete widget by using following settings. Autocomplete widget can still be triggered by running Trigger Suggest:

"editor.quickSuggestions": {
    "other": true,
    "comments": false,
    "strings": false
  }

How to contribute

Imposter syndrome disclaimer: I want your help. No really, I do.

There might be a little voice inside that tells you you're not ready; that you need to do one more tutorial, or learn another framework, or write a few more blog posts before you can help me with this project.

I assure you, that's not the case.

This project has some clear Contribution Guidelines and expectations that you can read here.

The contribution guidelines outline the process that you'll need to follow to get a patch merged. By making expectations and process explicit, I hope it will make it easier for you to contribute.

And you don't just have to write code. You can help out by writing documentation, tests, or even by giving feedback about this work. (And yes, that includes giving feedback about the contribution guidelines.)

Thank you for contributing!

Contributing and copyright

The project is hosted on GitHub where you can report issues, participate in discussions, fork the project and submit pull requests.

The library is available under MIT license, which allows modification and redistribution for both commercial and non-commercial purposes.

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.

Our Sponsors

Discover Panel is released as part of Ionide organization - OSS organization focused on building cross platform, developer tools.

You can support Ionide development on Open Collective.

Partners

drawing

Sponsors

Become a sponsor and get your logo on our README on Github, description in the VSCode marketplace and on ionide.io with a link to your site.

discover-panel's People

Contributors

krzysztof-cieslak avatar

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.