|
Hi everybody, in my few spare time I am creating a new article on the subject "multiple precision arithmetic" (MP for short).
I wrote about arithmetics sharing code snippets, at the end of the article I will present source code which runs unit tests and most notably collects statistics of different MP implementation.
I don't know what length an article should be, I just know the stuff I have is quite long. I'm afraid that a single long page could discourage audience, i could strip some paragraphs but I already removed much in the effort to balance clarity and brevity, I'd rather prefer to write a series of 5 articles.
I did not found on guidelines "what when and where" it is considered good practice to split long articles into chapters. There are limitations? Suggestions?
Best
Andrea
|
|
|
|
|
There are both possibilities:
Authors that like to post a big single object
Authors that like a lot do series "1 from N" format.
As long as the single articles don't get too short, and they finish what they start.... I would have no problem.
5 Articles is something manageable. I don't know what is the content, but a possible arrangement could be:
1 - Why, was, Theory background...
2 - Overview about what is coming with snippets and light explanations, how to use it and so on
3 - most interesting parts with deep explanations part 1
4 - most interesting parts with deep explanations part 2
5 - Explanations about the unit tests and statistics functionality that you mention. Practical use cases, comparisons and conclusions
Whole code and example project as a download in all or at least #3, #4 and #5
I personally think it is better if you prepare the work and use the draft functionality to write everything, and then publish with links to each other part in each article at the end, when everything is done. I don't like unfinished things and having to wait to understand the big picture.
|
|
|
|
|
Hi, thank you for answering.
I will follow your advice to publish all at once when ready then.
My goal is show (to who is interested) ideas about how to create their own MP library, being myself just an amateur on this kind of stuff.
I think to title the series "Teaching arithmetic to a computer" or maybe "The Big Integer Challenge" and divide the article into parts that could be viewed independently, all the code needed to study and build your own implementation is embedded on article.
Part #1 the sum
Sample summary:
* define sum, simple sum primitive to build long sum, base 10
* carry properties and implication
* from base 10 to any other base (specifically CPU register sized digits)
* The Long Sum algorithm, with flow chart
* carry propagation, carry detection on higher level languages
* listing in C language and x64 assembler with comments
* bar chart for above implementation timings
* Appendix
Part #2 the subtraction, Part #3 the multiplication
Part #4 the division: this will probably be the longest one.
Part #5 the arithmetic challenge: (did not start writing yet)
* show how to use the toy framework i created in order to validate other implementation and compare performance to the reference implementation
* evidence parts that need to be changed if porting the code outside of windows environment or different hardware platforms.
* install Microsft assembler extension on Visual Studio
* show how to create basic statistic from csv dataset generated by the program,
* (maybe) challenge the community members to fork and create new fastest implementation
In total the document should be like 50 printed pages if on WORD, kind of 8-12 pages per article.
Could that be ok? Which is a good measure of an article lenght expressed as "printed page"?
What about the source code, should I add it just once to the latest article? Because all the relevant sources are in a single project.
Best
Andrea
|
|
|
|
|
I am not a big writer myself, so I can only give my opinion.
As far as I know, there is no real "regulation", there are only minimum requirements. Not sure if you alredy have done it, but I recommend you to have a look into: https://www.codeproject.com/KB/FAQs/[^]
you will find some help about the site, how to publish and what tools you have to do it. I.e.:
Code Project Article FAQ[^]
Code Project Tags FAQ[^]
(just in case... CodeProject Plagiarism FAQ[^])
or the author resources (https://www.codeproject.com/KB/mentor/[^]). I.e:
Using the Article Editor (without losing your hair in handfuls)[^]
Article Formatting tips for CodeProject[^]
Formatting code in Tips and Tricks[^]
Markdown[^]
asimonassi wrote: I think to title the series "Teaching arithmetic to a computer" or maybe "The Big Integer Challenge" and divide the article into parts that could be viewed independently, all the code needed to study and build your own implementation is embedded on article.
Sounds good for me
asimonassi wrote: In total the document should be like 50 printed pages if on WORD, kind of 8-12 pages per article.
Sounds good for me
asimonassi wrote: What about the source code, should I add it just once to the latest article? Because all the relevant sources are in a single project.
You can attach it to every article as a download and post the most relevant and related snippets in the article to explain things
or...
You can post the most relevant and related snippets in the article to explain things and say that the whole download is on the last article of the serie, so that the reader knows where to find it.
Another thing I would do to help the readers is to keep a list of the links of the serie in all articles, so one can navigate without problems from one article to another. I mean:
In Article 1:
https://www.codeproject.com/article/part_1_of_5.aspx <<< this article (notice the no-clickability)
https://www.codeproject.com/article/part_2_of_5.aspx[^]
https://www.codeproject.com/article/part_3_of_5.aspx[^]
...
In Article 2:
https://www.codeproject.com/article/part_1_of_5.aspx[^]
https://www.codeproject.com/article/part_2_of_5.aspx <<< this article (notice the no-clickability)
https://www.codeproject.com/article/part_3_of_5.aspx[^]
...
M.D.V. 
If something has a solution... Why do we have to worry about?. If it has no solution... For what reason do we have to worry about?
Help me to understand what I'm saying, and I'll explain it better to you
Rating helpful answers is nice, but saying thanks can be even nicer.
|
|
|
|
|
Dynamically Configure web.config Connection String Input from Custom Window of Web Setup Installer[^] was not approved yet. First version was closed (I don't know why) and all other 5 pending.
But as it was edited by a CP-Editor got approved directly.
Not sure if quality is enough to even stay. But it now is out of moderation.
Maybe the "instant automatic approval" by CP Editors should be bypassed as default, I mean not changing the status on pending articles?
M.D.V.
If something has a solution... Why do we have to worry about?. If it has no solution... For what reason do we have to worry about?
Help me to understand what I'm saying, and I'll explain it better to you
Rating helpful answers is nice, but saying thanks can be even nicer.
|
|
|
|
|
Thank you for the report. The tip has been removed.
Thanks,
Sean Ewington
CodeProject
|
|
|
|
|
Can I submit an article written in LibreOffice HTML format?
Is there a way to import this site HTML article writing ( on line) template into LibreOffice?
Thanks
Cheers
Vaclav
|
|
|
|
|
Short introduction to parameter packs and fold expressions[^]
and
Fun with unordered containers[^]
By the way... @Sean-Ewington you told you don't like flooding blogs... this guy has posted more than 10 in the last 12 hours after 8 years of... nothing?
M.D.V.
If something has a solution... Why do we have to worry about?. If it has no solution... For what reason do we have to worry about?
Help me to understand what I'm saying, and I'll explain it better to you
Rating helpful answers is nice, but saying thanks can be even nicer.
|
|
|
|
|
Thanks for the report. Something tells me I said something like that when there was a guy who submitted 50 poor blog entries. I'm not worried about this guy just yet.
Thanks,
Sean Ewington
CodeProject
|
|
|
|
|
One of his blogs need help:
shrink_to_fit that doesn’t suck[^]
M.D.V.
If something has a solution... Why do we have to worry about?. If it has no solution... For what reason do we have to worry about?
Help me to understand what I'm saying, and I'll explain it better to you
Rating helpful answers is nice, but saying thanks can be even nicer.
|
|
|
|
|
I'm not sure why one would strikethrough half a blog post and keep it that way. I'm just going to remove it.
Thanks,
Sean Ewington
CodeProject
|
|
|
|
|
They are flooding in, and a number of them seem to be just paraphrasing someone else's work. However, since he acknowledges their origin it cannot really be called plagiarism.
|
|
|
|
|
|
My eyes. My eyes.
Thanks,
Sean Ewington
CodeProject
|
|
|
|
|
Another one... Think twice, cut once[^]
I think you will have to have some words with him
M.D.V.
If something has a solution... Why do we have to worry about?. If it has no solution... For what reason do we have to worry about?
Help me to understand what I'm saying, and I'll explain it better to you
Rating helpful answers is nice, but saying thanks can be even nicer.
|
|
|
|
|
|
Done. I don't blame users for our blog aggregator bringing stuff messy. Or asking them to format it when it gets here. It's always been like this.
Thanks,
Sean Ewington
CodeProject
|
|
|
|
|
Sean Ewington wrote: I don't blame users
Neither do I... I just ask you   
M.D.V.
If something has a solution... Why do we have to worry about?. If it has no solution... For what reason do we have to worry about?
Help me to understand what I'm saying, and I'll explain it better to you
Rating helpful answers is nice, but saying thanks can be even nicer.
|
|
|
|
|
modified 12-Mar-19 16:25pm.
|
|
|
|
|
|
Maybe move it there?
M.D.V.
If something has a solution... Why do we have to worry about?. If it has no solution... For what reason do we have to worry about?
Help me to understand what I'm saying, and I'll explain it better to you
Rating helpful answers is nice, but saying thanks can be even nicer.
|
|
|
|
|
Oh yea ...
Thanks,
Sean Ewington
CodeProject
|
|
|
|
|
What kind of articles can I post here?
Im a new member and was trying to figure out how to be part and helpful for this big community.
Do I have to post a new article or existing articles from my website. Do they have to be over 1000 words, there is any requirement?
I have all my content original of course.
My website is: --- [Link removed]
Thank you everyone
modified 7-Mar-19 1:16am.
|
|
|
|
|
I strongly recommend you to start reading:
https://www.codeproject.com/KB/FAQs/[^]
you will find most information over there.
e.g.
Code Project Article FAQ[^]
Code Project Technical Blog FAQ[^]
BIG NO-GO's:
1) No plagiarism (more in CodeProject Plagiarism FAQ[^] )
2) No spam
3) No site driving
I have deleted the link to your site in the message (No Go #3).
I don't care what you have there. Just be sure someone will check the things you publish here. If you are caught cheating... bye bye
M.D.V.
If something has a solution... Why do we have to worry about?. If it has no solution... For what reason do we have to worry about?
Help me to understand what I'm saying, and I'll explain it better to you
Rating helpful answers is nice, but saying thanks can be even nicer.
|
|
|
|
|
Thank you very much for your explanation. My apologies about home page link just wanted to make sure someone from technical support would be able to see what im talking about.
Anyway thanks again.
|
|
|
|
General 
News 
Suggestion 
Question 
Bug 
Answer 
Joke 
Praise 
Rant 
Admin 
Submit an article or tip
