24 votes

Any interest in helping me create tutorials for understanding the source code of Tildes?

Topic removed by site admin

16 comments

  1. [4]
    Deimos
    Link
    There's a fair amount of information on the Development page of the docs, have you looked at that? There could certainly be a lot more, and on that note, please don't do this via videos. Videos...

    There's a fair amount of information on the Development page of the docs, have you looked at that?

    There could certainly be a lot more, and on that note, please don't do this via videos. Videos are awful for reference material for many reasons—they're not searchable, they're difficult to skim, they can't easily be updated when things change, etc. If you do this by writing text instead, it could be integrated into the official docs and/or the repo itself.

    18 votes
    1. [2]
      halfjew22
      Link Parent
      Thanks for sharing. I somehow missed the development docs when browsing on mobile. I'll look into those. Having done some online teaching, I completely agree with you that they're a pain in the...

      Thanks for sharing. I somehow missed the development docs when browsing on mobile. I'll look into those.

      Having done some online teaching, I completely agree with you that they're a pain in the ass to update, if not just outright impossible. There is something to be said though for birds eye overview of architecture, how things go together, etc, that some learn more effectively with. It would be fun to just record the explorations of the source code with interested parties and learn how things go together (not insinuating in any way the docs aren't good - just different mode of learning)

      7 votes
      1. masochist
        Link Parent
        You can do that via text (maybe some diagrams if you must) which have the benefits of being visual for people who need that while still having none / few of the downsides of video.

        You can do that via text (maybe some diagrams if you must) which have the benefits of being visual for people who need that while still having none / few of the downsides of video.

        2 votes
    2. SourceContribute
      Link Parent
      As a counter-point, videos are great for showing things off and work as marketing. Getting some developers to check out Tildes source code through YouTube or Vimeo or Facebook Video or whatever,...

      Videos are awful for reference material for many reasons

      As a counter-point, videos are great for showing things off and work as marketing. Getting some developers to check out Tildes source code through YouTube or Vimeo or Facebook Video or whatever, could lead to a larger dev community.

      Aside from that, yeah agreed, videos are pretty bad for reference content and require lots of upkeep to keep them relevant for programming material.

      If you do this by writing text instead, it could be integrated into the official docs and/or the repo itself.

      On the plus side, the text can be adapted into a script for video production if @halfjew22 chooses to go that route.

      2 votes
  2. tgiles
    Link
    Hi New to Tildes, but an old hand at both Python (Since 2000) and Technical Writing (written many technical articles, a couple of company operations manuals, more policies and procedures than I'd...

    Hi

    New to Tildes, but an old hand at both Python (Since 2000) and Technical Writing (written many technical articles, a couple of company operations manuals, more policies and procedures than I'd like to think about). Hit me up if you need some firepower and I'd be happy to assist.

    Cheers!

    6 votes
  3. [7]
    Comment deleted by author
    Link
    1. [4]
      Amarok
      Link Parent
      That was a key reason it was chosen - Deimos said he wanted simple, reliable, proven, unsexy technology, something a lot of people know, something anyone can get into.

      That was a key reason it was chosen - Deimos said he wanted simple, reliable, proven, unsexy technology, something a lot of people know, something anyone can get into.

      7 votes
      1. [3]
        halfjew22
        Link Parent
        IIRC, he definitely uses the word 'unsexy' in the docs. I truly appreciate that. I'm currently working on a Nextjs project and am fed up with how React and this explosion of frameworks are trying...

        IIRC, he definitely uses the word 'unsexy' in the docs.

        I truly appreciate that.

        I'm currently working on a Nextjs project and am fed up with how React and this explosion of frameworks are trying to "shove their tits in my face" so to speak.

        Are you a developer on the project? Interested in helping me explore and teach others how to dive in?

        3 votes
        1. [2]
          Amarok
          Link Parent
          I'm a sysadmin by trade. I could contribute with docs that tell people how to set up a nice sexy version of Tildes of their own, and I can do that for a layman audience, I've written for that...

          I'm a sysadmin by trade. I could contribute with docs that tell people how to set up a nice sexy version of Tildes of their own, and I can do that for a layman audience, I've written for that purpose before many times. For anything more than that I'd need to learn Python.

          5 votes
          1. halfjew22
            Link Parent
            I think deimos beat us to it. https://docs.tildes.net/development-setup I’m generally a JS / Android developer but I’ve been wanting to get into Python for a while now and learning Pyramid gives...

            I think deimos beat us to it.

            https://docs.tildes.net/development-setup

            I’m generally a JS / Android developer but I’ve been wanting to get into Python for a while now and learning Pyramid gives me an excuse.

            Interested in learning together?

            4 votes
    2. [2]
      halfjew22
      Link Parent
      Python is certainly great. Do you have any experience pythoning the web?

      Python is certainly great. Do you have any experience pythoning the web?

      3 votes
      1. [2]
        Comment deleted by author
        Link Parent
        1. halfjew22
          Link Parent
          Gotcha. Well, if you’re interested in diving into pyramid together and Tildes, let me know!

          Gotcha. Well, if you’re interested in diving into pyramid together and Tildes, let me know!

          3 votes
  4. [3]
    Comment deleted by author
    Link
    1. Deimos
      Link Parent
      Were you doing it through Vagrant, or trying to do more of a "production" setup on a server/VPS?

      Were you doing it through Vagrant, or trying to do more of a "production" setup on a server/VPS?

      4 votes
    2. halfjew22
      Link Parent
      Well there's always opportunity to learn!

      Well there's always opportunity to learn!

      3 votes
  5. [3]
    Comment deleted by author
    Link
    1. [2]
      cfabbro
      (edited )
      Link Parent
      Tildes actually has a few user created, unofficial chat client channels/servers (including discord) which are listed on the unofficial wiki: https://unofficial-tildes-wiki.gitlab.io/chats/ The...

      Tildes actually has a few user created, unofficial chat client channels/servers (including discord) which are listed on the unofficial wiki: https://unofficial-tildes-wiki.gitlab.io/chats/

      The admins on one of them may be kind enough to set you all up a semi-private space there in order to organize this and communicate with one another. I have only ever used the discord, so can't speak to the others, but the discord is quite active and the admins there are pretty swell so I would suggest joining it and shooting them a message if you're interested, @halfjew22.

      2 votes
      1. halfjew22
        Link Parent
        Done! Thanks for the tip.

        Done! Thanks for the tip.

        1 vote
  6. Octofox
    Link
    I'm a ruby on rails developer and I just had a quick look through the source as was able to make sense of it. It looks to be a fairly standard MVC setup although controllers look like they are...

    I'm a ruby on rails developer and I just had a quick look through the source as was able to make sense of it. It looks to be a fairly standard MVC setup although controllers look like they are called views for some reason. I can see how a beginner programmer would be lost but if you are familiar with web dev you should be able to work it out without too many issues. Its not a very big app, way less models than I was expecting.

    1 vote