Tag Info

Hot answers tagged

30

The easiest way to accomplish this is with a flow chart diagram using MS Visio or something to that effect. That could look something like what Visustin - Export to Visio has on their page: Edits based on comments: As @Sharky said in the comments, "You may want to add pseudocode, also." Which, if you don't know, means English for ...


29

I have a feeling this question might be moved to the Stackoverflow site but Its an interesting question. The reason behind this was because Fortran introduced the concept of using "=" as assigning values from one variable to another which led to a lot of confusion about what to use as an equality operator. To quote this wikipedia article. The use of the ...


14

Let's start with the most important stuff. Here is a quick check list in order to verify solution maturity: Can a result be auto-generated for any given piece of code? Can it be continuously updated without any need in additional "adjustments"? Does the solution support deterministic and simple layouting? Can it visualise a simple switch-case with three ...


12

There are UX designers that can also create great icons. There are UX designers that can also write JavaScript. There are UX designers that can whip out SQL queries on demand. And then there are UX designers that don't do any of that. Point being, there is no one template for being a UX designer. Having a well-rounded set of extra skills is certainly a ...


12

As a programmer, I prefer the line breaking to happen at the boundaries of words (assuming your assessment that line breaking is needed is correct). However, I would change the way you break. Instead of continuing at column 0, I think you should continue at the same column as the line you are breaking, and you should indicate somehow that it is not a real ...


8

For replacements I always prefer to use double square brackets with natural language: Hello, [[first name]] Double brackets rarely appear in normal text but are easy to type and read, natural language removes the need to know/lookup field names. Alternatively you can use real data with highlighting and some tool-tips, bit trickier to implement but much ...


6

Breaking up words/names is a bad idea for the simple reason that it's hard to tell where the function name begins and where it ends. Names can be abstract which makes them even more difficult for the brain to stitch back together. The first just feels more natural and although still difficult to read, you quickly can understand that text is wrapping and ...


6

Whether my answer is useful will depend on the skillset and time available for the one doing this, so it may not be for everyone. But if you're able to take this solution it certainly has some upsides. Document with automated unit and/or integration tests. Create a basic test harness for the script, and present them as a list of "business rules" or "use ...


6

I would suggest adding drag handles on each block and let the user decide the ordering. You'll only need to ensure that no matter the order of blocks, the first block will always be an if block and the remaining blocks- else if. Refer the image for more details This way the user will come to know upfront that the blocks are drag-able, both on desktop as ...


5

All other answers suggest drag handles, but I suggest against that. The problem with drag handles is that: you ask the user to move a block from one position to a specific area. If he misses the area, errors can easily occur. if the block you're moving is too high, the travel distance can become cumbersome. it can be hard to implement drag handles suggest ...


5

Checking equality is not used exclusively in if statements. For example: are_equal = foo == bar If the syntax would allow for using single equals sign, such assignment would be ambiguous: are_equal = foo = bar This could either mean "compare foo and bar, and assign the result to are_equal", or "assign bar value to both are_equal and foo".


4

Convention (in whatever context you're working in) trumps all. Whatever your working group has decided upon should be observed. If you're in the process of determining coding conventions there's plenty of good anecdotal, language specific, advice available on the internet. I know of no studies that suggest a specific coding style is easier to read than ...


4

You need to know enough in the technology you are designing for to be able to estimate the effort for developing each of the alternative designs you might consider. As a UX designer, you are the person who negotiates with the users the way their interface will look like. The users will always push for what they imagine will fit their needs, plus eye candy. ...


3

Mailchimp uses and icon to indicate the draggability of the block. Google uses drag handles in Gmail, they appear on hover. Using an icon (any icon) or drag handles to indicate the object is draggable are both good solutions, but it all comes down to the affordance of the solutions. When showing it to your user, will they understand it's meaning? One ...


3

One option is to set a minimum width on the code container and let the user scroll horizontally. Code that wraps unexpectedly is confusing at best, and in languages like Python it will appear completely broken. (This would be overflow-x: auto or scroll on the code element's parent in CSS.) 80 monospaced characters is often the default line length.


3

Pursue the activities that make you most happy (and successful). Then seek clients/employers that have needs best suited to your interests. Its a two-way street and you'll also want to look for support in areas you'd like to grow or improve. For instance, someone with deep research background might do well with larger companies with many specialized roles, ...


3

I have never heard of any wrapping algorithm that would break up words on anything but syllables (or soft hyphens). So breaking up a words at any arbitrary character is certainly not advisable. For programmers words in code are identifiers or operators etc. They only have meaning as a whole. So in this contexts even breaking up on syllables is ill-advised.


3

After giving this much thought I am convinced that any attempt to make the flow of an entire program easy to understand by everyone will end up being harder to consume than the program code itself. All the code visualizations posted in this thread are harder to read than lines of text. Code is already short and to the point and the reason we use it to tell ...


3

One difficulty with this task is that simplifying the code for readability will generally make it represent only simple concepts. As such I think the best format would be something that had a way to adjust what the user was currently looking at depending on what their interest was. Specifically, you could make a flowchart which would show only the most ...


2

Make a toggle: Linebreak [yes] or [no]. Depending on the programming language being displayed, inserted linebreaks will alter the execution of the code. Once you do break the code onto a new line, indicate this by adding the linebreak character at the end of the line. With a toggle you will be able to give the user of your application the option of making ...


2

I know the good way of wrapping for humans, including developers. The first way. You don't break words. If you do break words, they are not readable anymore. When reaching the wrap point, you may make it clearer that the line continues, by putting at the right a symbol like an arrow ⤶. Nice text editors do that.


2

My answer will not be complete - bits and pieces really, I just want to hint at two aspects that I feel are worth not overlooking. (As I noted in comments, I've shared a few thoughts on the subject before - here). When I scan code I usually look at the left side of the screen and expect control flow statements to appear there so it is possible to ...


1

Is the reason you want to put 'redeem' on this page that all user commands can only be done through this page? Are the other tabs just for displaying information then? Because right now there's a 'buy queries' tab on the side which kind of breaks that idea... If the promo code adds more queries to the account, why not consolidate 'buy queries' and 'redeem ...


1

Option 1 - Show variables as in templating languages For a programmer this is easy to understand, but for a casual user this might be the first time they have ever used a variable. The biggest downside is that users may edit the variable, for example entering {{TMIE}} instead and wonder why it won't work. Another downside is that it looks very technical ...


1

I would do as you suggested and use up / down arrows on the if blocks as well as the individual conditions in case the user wanted to swap any of those as well. You can also make the arrows aware of their position by enabling / disabling them based on whether they can move their item up or down or not. Based on your image, here's what it could look like: ...


1

When I do lists of orderable elements, I try to avoid drag handles but only becuase they are fiddly with smaller UI elements in my case. Instead I implement Move Up and Move Down buttons on buttons or a context area (or both). The downside of directly replacing drag handles with buttons is that the user needs to reposition the mouse after each move action. ...


1

If I had to solve this problem, I would have combined two different ways to do it : Enabling the user to drag blocks to change their position. When one block is selected, using the arrows of the keyboard to change their position. I think that it's interesting to combine different ways to do something, so you could also display the arrows you was speaking ...


1

I have two answers for this question: 1- 3-30-300 second of finding an information (how to deal with information that can grow) Showing all the functions with a search bar is a must (clustering them can make it easier). Secondly these findings should be explained in a summarized way. If user wants to take more information and details about the same ...


1

These are some personal requests that hit my mind while reading your question and might or mightn't be liked by every other coder. Keep in mind what kind of coder will use your product esp. what code language and for what s/he is programming for (target). Navigation. Provide some sort of keyboard-only navigation in general. But especially when jumping ...


1

I can't answer about any usefulness in sense of code, but there surely can be some methods to improve code for perception. You should simply think about the code as the written product, that is read by human user (i.e. another programer or someone else), so among others, answer yourself to these questions: Who is the reader of code? Is it you, the author? ...



Only top voted, non community-wiki answers of a minimum length are eligible