Beefy Boxes and Bandwidth Generously Provided by pair Networks
"be consistent"

comment on

( #3333=superdoc: print w/replies, xml ) Need Help??

The first rule (or at least an important one) of software engineering is that a complete rewrite is never as good an idea as it seems.

You are correct to be concerned about making any moves that lead to a complete rewrite.

Look for ways that you can work these ideas in edgewise, at the margins. Move code around, change what happens behind the scenes, but keep the interfaces the same.

Having everything going through those 4 modules may be what makes it possible to change.

I'm willing to take a look at your Base::* modules and see what I think is reasonable to target for refactoring.

For example, to use my suggested approach for menus, you can start by changing your existing print_menu() in Base::Menu.

  • First put the logic that traverses your website into one routine, call it build_menu(). Build the menu data structure in build_menu().
  • Simply insert build_menu() at the top of your print_menu() routine and let it create the structure on the fly, exactly as it does now.
  • Then modify print_menu() to use the results of build_menu().
  • Now you can make a separate script that uses the build_menu() routine to build the menu data and save it to a file.
  • Modify Base::Menu::print_menu() to use data loaded from the file.
  • Now you can modify the build_menu() routine to handle the case where you have an all-in-one file, for example, Monsters
  • Now you can convert each directory to use an all-in-one approach.

    These steps don't require a rewrite, and at each part of the process you never have a broken website.

    Also, while it may have taken you several years to get where you are now, most of that work was not in the production of code, but rather, the acquisition of the knowledge required to produce the code.

    I think you may find that a better architecture will pay off handsomely. A good structure will come together with much less effort than a patched one.

    BTW, don't worry too much about UTF-8 until you need it. I haven't needed to worry about it, so I haven't bothered to learn anything other than the basics. I know that when I need to know, I will be able to find the resources I need to make it work. That is enough.

    TGI says moo

    In reply to Re^5: Seeing Perl in a new light: Epilog by TGI
    in thread Seeing Perl in a new light by Lady_Aleena

    Use:  <p> text here (a paragraph) </p>
    and:  <code> code here </code>
    to format your post; it's "PerlMonks-approved HTML":

  • Posts are HTML formatted. Put <p> </p> tags around your paragraphs. Put <code> </code> tags around your code and data!
  • Titles consisting of a single word are discouraged, and in most cases are disallowed outright.
  • Read Where should I post X? if you're not absolutely sure you're posting in the right place.
  • Please read these before you post! —
  • Posts may use any of the Perl Monks Approved HTML tags:
    a, abbr, b, big, blockquote, br, caption, center, col, colgroup, dd, del, div, dl, dt, em, font, h1, h2, h3, h4, h5, h6, hr, i, ins, li, ol, p, pre, readmore, small, span, spoiler, strike, strong, sub, sup, table, tbody, td, tfoot, th, thead, tr, tt, u, ul, wbr
  • You may need to use entities for some characters, as follows. (Exception: Within code tags, you can put the characters literally.)
            For:     Use:
    & &amp;
    < &lt;
    > &gt;
    [ &#91;
    ] &#93;
  • Link using PerlMonks shortcuts! What shortcuts can I use for linking?
  • See Writeup Formatting Tips and other pages linked from there for more info.
  • Log In?

    What's my password?
    Create A New User
    and the web crawler heard nothing...

    How do I use this? | Other CB clients
    Other Users?
    Others examining the Monastery: (8)
    As of 2021-04-15 07:38 GMT
    Find Nodes?
      Voting Booth?

      No recent polls found