Ridiculously high standards?

[woodb...@gmail.com]

Shalom

Can you give me some suggestions on how to
improve this:
https://github.com/Ebenezer-group/onwards


Thanks in advance.


Brian
Ebenezer Enterprises
http://webEbenezer.net

[Alf P. Steinbach]

On 08.04.2020 04:41, woodb...@gmail.com wrote:
>
> Can you give me some suggestions on how to
> improve this:
> https://github.com/Ebenezer-group/onwards

You can start by renaming the "Readme" file to "README.md", then Github
will display it as markdown. That means you can use e.g. *emphasis*,
headings, tables etc. You will probably have to rewrite "*nix" as
"\*nix" (it then presents as "*nix").

https://guides.github.com/features/mastering-markdown/

One nice advantage of markdown is that you can include images, such as a
graphic showing the data flow (or whatever's relevant) of your tools.

I use the Visual Code editor to edit Github markdown. It has a nice
dynamic result preview on the side.

---

"The C++ Middleware Writer (CMW) is an on-line code generator."

Well that could be anything. Assuming that it's about what I think it's
about I'd include mention of RPC in general and CORBA and Java RMI
(possibly also DCOM) as concrete examples. If your code generator
addresses a higher abstraction level then maybe also mention of MQ systems.

https://en.wikipedia.org/wiki/Remote_procedure_call
https://en.wikipedia.org/wiki/Common_Object_Request_Broker_Architecture
https://en.wikipedia.org/wiki/Java_remote_method_invocation
https://en.wikipedia.org/wiki/Distributed_Component_Object_Model
https://en.wikipedia.org/wiki/Message_queue

---

Three things I noticed reading the "Readme":

* The need to run a component on a *nix system. Huh.
* The need for an account number in invocations. Huh.
* No link to example. That's easy with markdown. ;-)

- Alf

[Brian Wood]

There are many free *nix operating systems.

[Öö Tiib]

Who cares? There are technology companies with billion dollar turnover
whose IT does not just let to put such system into their network.
Case closed.

What about other remarks of Alf? Let me restore:

* The need for an account number in invocations. Huh.
* No link to example.

Just learn from README.md of repository of (perhaps best ATM) competitor:
<https://github.com/google/flatbuffers>

1) Two-three lines of what it is so no one can say TL;DR to it.
2) Link to detailed docs (detailed descriptions, videos, examples,
tutorials etc. are all there).
3) Answers or links for questions that one does not want to search from docs.
* what platforms are supported?
* what programming languages are supported?
* where is forum?
* where is issue tracker?
* where is q/a site?
* how to contribute?
* what is usage license?

[Brian Wood]

I'm not seeking to persuade large companies. I'm
focused on individuals and small companies.

Large companies have spent how many billions developing
O3 optimizations? In the talk "Performance Matters"

https://www.reddit.com/r/cpp/comments/j2nxi1/plenary_performance_matters_emery_berger_cppcon/

Emery Berger claims that the difference between O2 and O3
is noise -- not statistically relevant. If you've followed this
newsgroup for any length of time, you will recall that I've been
an O3 skeptic. I can back that up with my Github repo.

Mr. Berger also has the temerity to mention Mount Sinai,
tablets and G-d in the talk.

>
> What about other remarks of Alf? Let me restore:
> * The need for an account number in invocations. Huh.
> * No link to example.
> Just learn from README.md of repository of (perhaps best ATM) competitor:
> <https://github.com/google/flatbuffers>
>
> 1) Two-three lines of what it is so no one can say TL;DR to it.
> 2) Link to detailed docs (detailed descriptions, videos, examples,
> tutorials etc. are all there).
> 3) Answers or links for questions that one does not want to search from docs.
> * what platforms are supported?

FreeBSD, Linux, Mac, Windows. It can be extended to others
fairly easily.

> * what programming languages are supported?
> * where is forum?
> * where is issue tracker?
> * where is q/a site?

I'm not sure which one to start with of the last three.

> * how to contribute?
https://webEbenezer.net/about.html

> * what is usage license?

https://github.com/Ebenezer-group/onwards/blob/master/LICENSE
BSD License

Copyright (c) 2016-2020, Brian Wood
All rights reserved.
https://webEbenezer.net

Redistribution and use in source and binary forms, with or without
modification, are permitted.


Brian

[Öö Tiib]

That misses what I meant. I meant that if even large and powerful
technology companies try to keep their technology stack narrow and
focused to reduce costs then your idea that successful small
companies or individuals do not care about it is wildly misplaced.

>
> >
> > What about other remarks of Alf? Let me restore:
> > * The need for an account number in invocations. Huh.
> > * No link to example.
> > Just learn from README.md of repository of (perhaps best ATM) competitor:
> > <https://github.com/google/flatbuffers>
> >
> > 1) Two-three lines of what it is so no one can say TL;DR to it.
> > 2) Link to detailed docs (detailed descriptions, videos, examples,
> > tutorials etc. are all there).
> > 3) Answers or links for questions that one does not want to search from docs.
> > * what platforms are supported?
>
> FreeBSD, Linux, Mac, Windows. It can be extended to others
> fairly easily.

I mean't you should try to honestly explain in your README.md why it
is so what Alf asked and otherwise try to be close enough to
clarity of your competitors.

>
> > * what programming languages are supported?
> > * where is forum?
> > * where is issue tracker?
> > * where is q/a site?
>
> I'm not sure which one to start with of the last three.

I can't imagine projects without issue tracker.

The q/a site and forum can be merged and you can perhaps use something
like discord or reddit for those ... main problem is that it does take
constant, possibly irritating, efforts.

And put the other things also to your README.md, no one will search
those from comp.lang.c++

[daniel...@gmail.com]

On Tuesday, April 7, 2020 at 10:41:24 PM UTC-4, woodb...@gmail.com wrote:
> Shalom
>
> Can you give me some suggestions on how to
> improve this:
> https://github.com/Ebenezer-group/onwards
>

Your README has to answer the question: what is this thing and why would anybody want to use it? "[Provides] support for messaging and serialization" isn't enough. Lots of C++ libraries with active communities and large user bases have that. Many support standardized, schema-less data formats such as JSON, CBOR and MessagePack, and thus have interoperability. Some are quite good at non-intrusive serialization. What does your library offer that is compelling enough to win converts?

Daniel

[Mr Flibble]

We still don't know what this software actually does or what its purpose actually is and how it can possibly be good idea to send passwords in cleartext over an insecure connection or involve your server(s) in what can be done locally.

/Flibble

--
¬

[Brian Wood]

Somehow it may have escaped you that my code generation
service is free. Beyond that I'm willing to spend 16 hours/
week on a project if we use my software as part of the
project: https://webEbenezer.net/about.html

.
> > >
> > > What about other remarks of Alf? Let me restore:
> > > * The need for an account number in invocations. Huh.

Without accounts all files would have to sent with each
request. Accounts are needed to provide quick response
times.

> > > * No link to example.
> > > Just learn from README.md of repository of (perhaps best ATM) competitor:
> > > <https://github.com/google/flatbuffers>
> > >
> > > 1) Two-three lines of what it is so no one can say TL;DR to it.
> > > 2) Link to detailed docs (detailed descriptions, videos, examples,
> > > tutorials etc. are all there).
> > > 3) Answers or links for questions that one does not want to search from docs.
> > > * what platforms are supported?
> >
> > FreeBSD, Linux, Mac, Windows. It can be extended to others
> > fairly easily.
> I mean't you should try to honestly explain in your README.md why it
> is so what Alf asked and otherwise try to be close enough to
> clarity of your competitors.
> >
> > > * what programming languages are supported?
> > > * where is forum?
> > > * where is issue tracker?
> > > * where is q/a site?
> >
> > I'm not sure which one to start with of the last three.
> I can't imagine projects without issue tracker.

Is there something wrong with using Github to track issues?

[Brian Wood]

On Thursday, October 1, 2020 at 12:25:58 PM UTC-5, Mr Flibble wrote:
> On 08/04/2020 03:41, woodb...@gmail.com wrote:
> > Shalom
> >
> > Can you give me some suggestions on how to
> > improve this:
> > https://github.com/Ebenezer-group/onwards
> >
> >
> > Thanks in advance.
> >
> >
> > Brian
> > Ebenezer Enterprises
> > http://webEbenezer.net
> We

Breaking up a mob isn't much fun.

> still don't know what this software actually does or what its
> purpose actually is and how it can possibly be good idea to send passwords in cleartext

I never claimed it's a good idea.

> over an insecure connection

I use Wireguard.

or involve your server(s) in what can be done locally.
>

These are some of the tags on my Github archive:
cross-platform, middleware, network programming, protocols,
serialization, messaging, managed services, SaaS,
three-tier architecture, organic, Archimedes, Jerusalem.

G-d willing the company will continue to grow into these
areas.


Brian
Ebenezer Enterprises

[Öö Tiib]

Somehow that is utterly irrelevant. What it has to do with running
one component on Windows and other on Linux? No one is going to
provide promise of usage of unknown thing in their real product.

Ultimately they want to try what it does and what its performance
of communication between two random test programs. But if they see
they have to run some kind of separate Linux box for to do
serialization then they say: "Huh?" Serialization with FlatBuffers
can go on between micro-controllers inside of embedded system
if needed. Utterly out of reach for whatever Linux boxes. So then
they just drop the idea.

All of FlatBuffers is free, including code generation tools that
are also buildable executables in that repo with documentation
of building instructions and usage instructions and examples.

> > > >
> > > > What about other remarks of Alf? Let me restore:
> > > > * The need for an account number in invocations. Huh.
>
> Without accounts all files would have to sent with each
> request. Accounts are needed to provide quick response
> times.

Yes, write that some account has to made somewhere and all files need
to be FTPd somewhere separately if link to repo is not good enough.
People do not understand what this thing is and how it works. Maybe
someone tries but I doubt it.

> > > > * No link to example.
> > > > Just learn from README.md of repository of (perhaps best ATM) competitor:
> > > > <https://github.com/google/flatbuffers>
> > > >
> > > > 1) Two-three lines of what it is so no one can say TL;DR to it.
> > > > 2) Link to detailed docs (detailed descriptions, videos, examples,
> > > > tutorials etc. are all there).
> > > > 3) Answers or links for questions that one does not want to search from docs.
> > > > * what platforms are supported?
> > >
> > > FreeBSD, Linux, Mac, Windows. It can be extended to others
> > > fairly easily.
> > I mean't you should try to honestly explain in your README.md why it
> > is so what Alf asked and otherwise try to be close enough to
> > clarity of your competitors.
> > >
> > > > * what programming languages are supported?
> > > > * where is forum?
> > > > * where is issue tracker?
> > > > * where is q/a site?
> > >
> > > I'm not sure which one to start with of the last three.
> > I can't imagine projects without issue tracker.
>
> Is there something wrong with using Github to track issues?

Didn't you notice that the example I brought, FlatBuffers, uses
GitHub for issue tracker? I said it is courtesy to provide link
in README as many projects use separate issue trackers.
Or if you like particular issue reporting template to be used
then to provide link to it.

[Scott Lurndal]

Brian Wood <woodb...@gmail.com> writes:
>On Thursday, October 1, 2020 at 4:52:35 AM UTC-5, =C3=96=C3=B6 Tiib wrote:

>> That misses what I meant. I meant that if even large and powerful=20
>> technology companies try to keep their technology stack narrow and=20
>> focused to reduce costs then your idea that successful small=20

>> companies or individuals do not care about it is wildly misplaced.
>
>Somehow it may have escaped you that my code generation
>service is free. Beyond that I'm willing to spend 16 hours/
>week on a project if we use my software as part of the
>project: https://webEbenezer.net/about.html

TANSTAAFL.

And who wants a third party dependency just to build their code?

[Mr Flibble]

Your god doesn't exist, mate, much like your customers.

/Flibble

--
¬

[Brian Wood]

Duckduckgo is close. I've been using them for decades
and they haven't been tracking me.

> And who wants a third party dependency just to build their code?

Same people that like paying for electricity?


Brian
Ebenezer Enterprises - Enjoying programming again.
https://github.com/Ebenezer-group/onwards

[Brian Wood]

I'm seeking some external users: https://webEbenezer.net/about.hmtl


Brian
Ebenezer Enterprises - "Finally, my brothers, rejoice in the L-rd."
Philippians 3:1

https://github.com/Ebenezer-group/onwards

[Chris M. Thomasson]

On 10/3/2020 7:47 PM, Brian Wood wrote:
> On Friday, October 2, 2020 at 2:10:25 PM UTC-5, Mr Flibble wrote:
>> On 02/10/2020 06:45, Brian Wood wrote:
>>> These are some of the tags on my Github archive:
>>> cross-platform, middleware, network programming, protocols,
>>> serialization, messaging, managed services, SaaS,
>>> three-tier architecture, organic, Archimedes, Jerusalem.
>>>
>>> G-d willing the company will continue to grow into these
>>> areas.
>> Your god doesn't exist, mate, much like your customers.
>
> I'm seeking some external users: https://webEbenezer.net/about.hmtl

[...]

you mean:

https://webebenezer.net/about.html

right?

[Brian Wood]

The only difference I see is you didn't capitalize a letter.

That page doesn't mention it, but you can refer yourself.
That way you get both time spent on your project and
the referral bonus.

Brian

[Ben Bacarisse]

Brian Wood <woodb...@gmail.com> writes:

> On Saturday, October 3, 2020 at 11:41:48 PM UTC-5, Chris M. Thomasson wrote:
>> On 10/3/2020 7:47 PM, Brian Wood wrote:

<cut>

>> > I'm seeking some external users: https://webEbenezer.net/about.hmtl
>> [...]
>>
>> you mean:
>>
>> https://webebenezer.net/about.html
>>
>> right?
>
> The only difference I see is you didn't capitalize a letter.

Which (as you probably know) makes no difference in a domain name. But
you typed H-M-T-L not H-T-M-L as well.

--
Ben.

[Brian Wood]

On Sunday, September 27, 2020 at 9:57:50 AM UTC-5, Öö Tiib wrote:

I took his advice and made my ReadMe a markdown file.
I don't know what to say to "Huh". Accounts are common.
Someone may say that Compiler Explorer doesn't have
accounts. My guess is they will probably add them before
long. When I started, I had a web service and didn't require
accounts. After a few years of that someone on a Boost
list, suggested having a command line interface. That
made sense and when I changed to that approach I added
support for accounts. It would be nice to be able to
maintain both a CLI and a web interface, but I decided not
to attempt that. I think the CLI is more important.

> * No link to example.

I added that now. Thanks.

[Öö Tiib]

Good. Usage of .md files for giving explanations to contents of
repo has been standard for a while.

> I don't know what to say to "Huh". Accounts are common.

These are used for case when I let customers to post content
to my site (to block them from annoying other customers) or
when they buy something from me for money (to reduce
attempts of cheating). No way I would let anyone identify
themselves for reading my site or for downloading and trying
something I said is free to try there.

> Someone may say that Compiler Explorer doesn't have
> accounts. My guess is they will probably add them before
> long. When I started, I had a web service and didn't require
> accounts. After a few years of that someone on a Boost
> list, suggested having a command line interface. That
> made sense and when I changed to that approach I added
> support for accounts. It would be nice to be able to
> maintain both a CLI and a web interface, but I decided not
> to attempt that. I think the CLI is more important.

You do not think what is the benefit of others from you.
You think about yourself, how you did things. Throw that
away, no one cares. That part only makes it hard for you
to make successful things. Care about convenience and
benefit of others.

People think: That guy annoys with accounts. Do I want to test
his stuff so badly to make account? FlatBuffers do not require
me to make account. Probably it is some kind of scam to get
my e-mail or something and then spam me. Should I
manufacture some false, throw-away identity to try his
garbage? Yuck.

See, you have already lost by asking for account.

[Brian Wood]

I'm not asking anyone to identify themselves for reading my
site or downloading my open-source software. If you want
to use my closed-source software, you have to have an
account.

> > Someone may say that Compiler Explorer doesn't have
> > accounts. My guess is they will probably add them before
> > long. When I started, I had a web service and didn't require
> > accounts. After a few years of that someone on a Boost
> > list, suggested having a command line interface. That
> > made sense and when I changed to that approach I added
> > support for accounts. It would be nice to be able to
> > maintain both a CLI and a web interface, but I decided not
> > to attempt that. I think the CLI is more important.
> You do not think what is the benefit of others from you.
> You think about yourself, how you did things. Throw that
> away, no one cares. That part only makes it hard for you
> to make successful things. Care about convenience and
> benefit of others.
>
> People think: That guy annoys with accounts. Do I want to test
> his stuff so badly to make account? FlatBuffers do not require
> me to make account. Probably it is some kind of scam to get
> my e-mail or something and then spam me.

I've been on this list for over 16 years and have been improving
my software. We could, for example, go back to the first commits
of my repo and compare how long it takes to build then and now,
the sizes of the executables then and now, the additional
functionality, etc.

I believe having some closed-source software (private property)
is the way to go.

> Should I
> manufacture some false, throw-away identity to try his
> garbage? Yuck.

Feel free to point out some weaknesses. My FixedVector
class is new and it needs some help.

I think these programs are in fairly good shape:
https://github.com/Ebenezer-group/onwards/blob/master/src/tiers/genz.cc
https://github.com/Ebenezer-group/onwards/blob/master/src/tiers/cmwA.cc

Only been working on them for 11 years.

>
> See, you have already lost by asking for account.

Providing a SaaS was a great idea when I started and still is.
Building a (walled) garden is a privilege and adventure. I hope
to continue to grow into these areas: cross-platform,
middleware, network-programming, serialization,
messaging, managed-services.

Brian
Ebenezer Enterprises - Enjoying programming again.

https://webEbenezer.net

[Öö Tiib]

On Sunday, 3 January 2021 at 02:10:10 UTC+2, woodb...@gmail.com wrote:
> On Saturday, January 2, 2021 at 8:41:18 AM UTC-6, Öö Tiib wrote:

Read again:

> > You do not think what is the benefit of others from you.
> > You think about yourself, how you did things. Throw that
> > away, no one cares. That part only makes it hard for you
> > to make successful things. Care about convenience and
> > benefit of others.
> >
> > People think: That guy annoys with accounts. Do I want to test
> > his stuff so badly to make account? FlatBuffers do not require
> > me to make account. Probably it is some kind of scam to get
> > my e-mail or something and then spam me.
> I've been on this list for over 16 years and have been improving
> my software. We could, for example, go back to the first commits
> of my repo and compare how long it takes to build then and now,
> the sizes of the executables then and now, the additional
> functionality, etc.
>
> I believe having some closed-source software (private property)
> is the way to go.

We are not talking about you, we are talking about your potential
customers who do not know you nor care about you.

> > Should I
> > manufacture some false, throw-away identity to try his
> > garbage? Yuck.
> Feel free to point out some weaknesses. My FixedVector
> class is new and it needs some help.

I haven't even tried to use it. Only looked into code. Code
like all the other millions of lines of code I've seen. Problem
of none of programmers is that they lack code for something.
There is usually annoyingly long list of choices instead.
So what matters are benefits, downsides and effort needed
to use one or other in that long list. You have made the item
that you name "middleware writer" tiresome to even evaluate
if it has any benefits whatsoever in that pile of inconveniences
so it never enters that list of choices of smart and
hard-working people.

> I think these programs are in fairly good shape:
> https://github.com/Ebenezer-group/onwards/blob/master/src/tiers/genz.cc
> https://github.com/Ebenezer-group/onwards/blob/master/src/tiers/cmwA.cc
>
> Only been working on them for 11 years.

Yes, people do not care about you or your code. I said

"Throw that away, no one cares. That part only makes it hard for
you to make successful things. Care about convenience and

benefit of others." Only if you ever cared about others for just
a bit there is chance that they start to care about whatever
you have made.

> > See, you have already lost by asking for account.
> Providing a SaaS was a great idea when I started and still is.
> Building a (walled) garden is a privilege and adventure. I hope
> to continue to grow into these areas: cross-platform,
> middleware, network-programming, serialization,
> messaging, managed-services.

Yes, and people do not care about you, your code or your
"walled garden". Think why you fought edit war of Wikipedia
with Leigh? You wanted to advertise your "walled garden" so
people would come to see it. Why? Why you spam about thing
no one wants to see? May be few wanted to see it ever. No
one of these few has said that they did like what they saw.
It is because you did not care about them but about yourself.