|
Many moons ago I worked on a project in need of a file record manager. We didn't have the resources to build it from scratch, and searched for a library. As we would have to make adaptations, we needed open source solutions.
We settled for one alternative recommended by several users - but it turned out to be useless to us: Every internal function, every variable, every comment was in French. None of us knew any French at all. We made a serious try to understand the workings of a few of the functions, but had to give up - it would be easier to write it from scratch ourselves (which had been ruled out for resource reasons).
Even long before that, I have in my code followed two rules: Everything that only a programmer will see is in English (including off line documentation). Anything that will be seen by a user, including the most advanced users, is in the language of the user (including all the online or offline documentation a user will ever see) - i.e. it may appear in multiple languages, so the texts should be organized for simple translation, in separate modules/files. So I never use Norwegian variable names in my code, even if the all the users of the program are Norwegians.
Religious freedom is the freedom to say that two plus two make five.
|
|
|
|
|
|
Ha ha.. looks like "CharlesFilter" wins?
That site is pretty sweet. Might actually use it once I put together more options.
|
|
|
|
|
I love !!!
I am working on a image file viewer thingy using Windows Imaging Components. I was going to call it WinCodecBitmap, but after spinning the wheel I think I will call it Hanna.
Thanks
Within you lies the power for good - Use it!
|
|
|
|
|
That's brilliant. I'm going to use these in our standups, 'cause our current order is by volunteer.
There are no solutions, only trade-offs. - Thomas Sowell
A day can really slip by when you're deliberately avoiding what you're supposed to do. - Calvin (Bill Watterson, Calvin & Hobbes)
|
|
|
|
|
I clicked on the link because it would be a programming revelation
YES I am still learning no revelations here keep moving
I now know better humor is worth more than revelations
made me laugh Caught Covid yesterday so needed a laugh
Chris Maunder2
|
|
|
|
|
the dreaded 'vid. Salt water gargle and netflix. I hope it brushes you lightly.
cheers
Chris Maunder
|
|
|
|
|
I put together the two suggestions (M-W thesaurus and wheel of names). I pasted the list of related words in wheel of names and a clairvoyant spin produced the right answer: WASH. Like in: if you don't know what to name it, it's a wash; any name is as good as the next.
Mircea
|
|
|
|
|
Perfect task for Copilot.
I gave it the entire text of your original post and here is Copilot's response.
Copilot said: Ah, the eternal struggle of naming things in software development! It’s a challenge that many of us face, and it’s perfectly normal to fret over it. After all, a good name can make your code more readable and maintainable, while a poor one can lead to confusion and frustration.
Here are a few strategies you might consider when naming your new components:
Descriptive Names:
Aim for names that clearly convey the purpose or functionality of the component. For example:
FilterPanel: If your component handles filtering functionality.
FilterOptions: If it’s related to filter configuration.
FilterSelector: If it allows users to choose from different filters.
Think about what the component does and choose a name that reflects that.
Domain-Specific Terms:
Consider using terms from your project’s domain or industry. For instance:
TagCloud: If your component deals with tags.
SearchCriteria: If it represents search filters.
SortDropdown: If it handles sorting options.
Using domain-specific terms can make your code more intuitive for other developers.
Avoid Generic Names:
As you mentioned, names like “NewFilter” or “Filter2” aren’t very helpful. They lack specificity and might cause confusion down the road.
Instead, opt for more meaningful names that provide context.
Be Consistent:
If your existing components follow a certain naming convention (e.g., “FilterGroup”), try to maintain consistency.
Consistency makes it easier for developers to understand the relationships between components.
Avoid Abbreviations:
While abbreviations can save keystrokes, they often sacrifice clarity.
For example, prefer FilterConfiguration over FilterConfig.
Think About Future Iterations:
You’re right to consider future-proofing your names. Think about how the component might evolve.
Instead of “Filter2,” consider something like “AdvancedFilter” or “EnhancedFilter.”
Remember that there’s no one-size-fits-all answer, and different projects and teams have varying conventions. Ultimately, choose names that make sense in your specific context. And don’t worry—you’re not alone in this naming struggle! 😄
|
|
|
|
|
Filter2024
or
FilterTOS
FilterTNG
FilterDS9
FilterVGR
So old that I did my first coding in octal via switches on a DEC PDP 8
|
|
|
|
|
Yeah, I thought if there's no additional context beyond versioning a date works well (i.e. your `Filter2024` suggestion), as you shouldn't be refactoring multiple times per year, and keeping track of dates is easier than using any versioning system (e.g. if one component didn't get redefined when doing the v2 work, when you refactor again does that component jump straight to v3, or should it be the v2 of that component despite being v3 of the whole / etc).
|
|
|
|
|
FilterNew, Filter2, etc, as you put it, are bad options.
Try to add a bit of context to the name to differentiate it from other filters you may have elsewhere. What type of thing it's supposed to be filtering. If it's intended to filter items that all have the same interface (IBlob) or share a common base class (Blob), maybe BlobFilter. That sort of thing. Don't overthink it.
|
|
|
|
|
GefilterFish
Cheers,
Mike Fidler
"I intend to live forever - so far, so good." Steven Wright
"I almost had a psychic girlfriend but she left me before we met." Also Steven Wright
"I'm addicted to placebos. I could quit, but it wouldn't matter." Steven Wright yet again.
|
|
|
|
|
|
Colonder.
It doubles as a filter AND a calendar component for enterologist offices.
|
|
|
|
|
If you don't get over using "2", you will eventually have the same problem again, and you will forget which is the current one.
|
|
|
|
|
OMG, you've just reminded me that Microsoft itself is very much guilty of that right in plain ol' Win32. I don't remember what component exactly--something to do with retrieving network configuration data--and they oh-so-wisely chose to append "2" at the end of some function names (and structs) to differentiate them from previous versions (you can't just remove functions from the standard Win32 set without breaking stuff). Someone remembers what I'm talking about, I'm sure, I can't be bothered to look it up right now. I'm pretty sure I also saw a "3"...proving your point.
With names like that, nobody but the original author, who is intimately familiar with the underlying implementation, ever stands a chance of remembering which does what, and you constantly have to go back to documentation. Assuming it exists and is adequate enough to point out the differences.
I absolutely believe in the saying that properly naming things is, indeed, one of the hardest computer science problems.
|
|
|
|
|
InternetExplorer as a component: WebView.
Edge as a component: WebView2.
(This is an unresearched posting, but pretty close if wrong)
|
|
|
|
|
Jeez, I didn't even think about that one, and I've just spent quite a bit of time migrating over an old piece of code leveraging WebView to WebView2.
At least in this case it's pretty clear WebView was built around IE, and WebView2 is the Edge version, and I just "naturally" think about it in those terms. There are components however where you just don't know unless you check the documentation.
|
|
|
|
|
|
Does your programming language support namespaces? Then I‘d stay with Filter but put it in a different namespace. Then you would ‚only‘ need a name for the namespace. During a transition phase you must specify the namespace, if both types can be used in parallel.
|
|
|
|
|
Looking for recommendations here...
I'm using Oracle Box VM. When I RDC into it, strange things happen.
First, Copy & Paste no longer works. Not Host to Remote, I'm talking about Copy & Paste INSIDE RDC. Select text, copy -> paste - Nothing.
It's also REALLY slow. I've tried various things like restarting rdpclip.exe. Still can't copy & paste.
If I work through the OracleBox window, everything is fine - except I can only use one monitor. Anyone know of a decent replacement that allows dual monitors?
NOTE: I don't want to TOGGLE between monitors, I want full use of both monitors.
Thanks
In theory, theory and practice are the same. But in practice, they never are.”
If it's not broken, fix it until it is.
Everything makes sense in someone's mind.
modified 28-May-24 15:22pm.
|
|
|
|
|
I use RDC on a dual-monitor Windows 10 system (left monitor) to connect to a single-monitor Windows 7 system (right monitor). I can copy & paste between the two. Your experience is different, though, correct?
"One man's wage rise is another man's price increase." - Harold Wilson
"Fireproof doesn't mean the fire will never come. It means when the fire comes that you will be able to withstand it." - Michael Simmons
"You can easily judge the character of a man by how he treats those who can do nothing for him." - James D. Miles
|
|
|
|
|
I'm taking about copy & paste INSIDE RDC. Not from Host to Remote
In theory, theory and practice are the same. But in practice, they never are.”
If it's not broken, fix it until it is.
Everything makes sense in someone's mind.
|
|
|
|
|
I just now tried that, too, and it works as expected. I was using a couple of Notepad windows.
"One man's wage rise is another man's price increase." - Harold Wilson
"Fireproof doesn't mean the fire will never come. It means when the fire comes that you will be able to withstand it." - Michael Simmons
"You can easily judge the character of a man by how he treats those who can do nothing for him." - James D. Miles
|
|
|
|